Skip to content

Commit a3c9d34

Browse files
authored
Merge pull request #5942 from MicrosoftDocs/main
5/29/2025 AM Publish
2 parents 8d26cab + fa38eaf commit a3c9d34

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+165
-188
lines changed

docs/atl-mfc-shared/reference/csize-class.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,9 @@
11
---
2-
description: "Learn more about: CSize Class"
32
title: "CSize Class"
4-
ms.date: "10/18/2018"
3+
description: "Learn more about: CSize Class"
4+
ms.date: 10/18/2018
55
f1_keywords: ["CSize", "ATLTYPES/ATL::CSize", "ATLTYPES/ATL::CSize::CSize"]
66
helpviewer_keywords: ["SIZE", "dimensions, MFC", "dimensions", "CSize class"]
7-
ms.assetid: fb2cf85a-0bc1-46f8-892b-309c108b52ae
87
---
98
# CSize Class
109

@@ -101,7 +100,7 @@ BOOL operator==(SIZE size) const throw();
101100

102101
### Remarks
103102

104-
Returns nonzero if the sizes are equal, otherwize 0.
103+
Returns nonzero if the sizes are equal, otherwise 0.
105104

106105
### Example
107106

docs/build-insights/tutorials/build-insights-function-view.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -63,7 +63,7 @@ When the build finishes, an Event Trace Log (ETL) file opens. It's saved in the
6363
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.
6464

6565
:::image type="complex" source="./media/functions-view-before-fix.png" alt-text="Screenshot of the Build Insights Functions view file.":::
66-
In the Function Name column, performPhysicsCalculations() is highlighted and marked with a fire icon.:::
66+
In the Function Name column, performPhysicsCalculations() is highlighted and marked with a fire icon.
6767
:::image-end:::
6868

6969
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.
@@ -112,7 +112,7 @@ We rerun Build Insights from the main menu by choosing **Build** > **Run Build I
112112
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.
113113
114114
:::image type="complex" source="./media/functions-view-after-fix.png" alt-text="Screenshot of the 2D vector header file.":::
115-
In the Function Name column, performPhysicsCalculations() is highlighted and marked with a fire icon.:::
115+
In the Function Name column, performPhysicsCalculations() is highlighted and marked with a fire icon.
116116
:::image-end:::
117117
118118
The Diagnostics Session time is the overall time it took do the build plus any overhead for gathering the Build Insights data.

docs/build/reference/dumpbin-options.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
11
---
22
title: "DUMPBIN options"
33
description: "Reference guide to the Microsoft DUMPBIN utility command-line options."
4-
ms.date: "02/09/2020"
4+
ms.date: 02/09/2020
55
helpviewer_keywords: ["DUMPBIN program, options"]
6-
ms.assetid: 563b696e-7599-4480-94b9-014776289ec8
76
---
87
# DUMPBIN options
98

@@ -49,7 +48,7 @@ DUMPBIN has the following options:
4948

5049
- [/PDBPATH\[:VERBOSE\]](pdbpath.md)
5150

52-
- [/RANGEE:vaMin\[,vaMax\]](range.md)
51+
- [/RANGE:vaMin\[,vaMax\]](range.md)
5352

5453
- [/RAWDATA\[:{NONE\|1\|2\|4\|8}\[,#\]\]](rawdata.md)
5554

docs/build/reference/gs-buffer-security-check.md

Lines changed: 6 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,9 @@
11
---
2-
description: "Learn more about: /GS (Buffer Security Check)"
32
title: "/GS (Buffer Security Check)"
4-
ms.date: "11/04/2016"
3+
description: "Learn more about: /GS (Buffer Security Check)"
4+
ms.date: 11/04/2016
55
f1_keywords: ["VC.Project.VCCLWCECompilerTool.BufferSecurityCheck", "VC.Project.VCCLCompilerTool.BufferSecurityCheck"]
66
helpviewer_keywords: ["buffers [C++], buffer overruns", "buffer overruns, compiler /GS switch", "GS compiler option [C++]", "/GS compiler option [C++]", "security check compiler option [C++]", "-GS compiler option [C++]", "buffers [C++], avoiding overruns"]
7-
ms.assetid: 8d8a5ea1-cd5e-42e1-bc36-66e1cd7e731e
87
---
98
# /GS (Buffer Security Check)
109

@@ -29,11 +28,8 @@ On functions that the compiler recognizes as subject to buffer overrun problems,
2928
A buffer overrun security check is performed on a *GS buffer*. A GS buffer can be one of these:
3029

3130
- An array that is larger than 4 bytes, has more than two elements, and has an element type that is not a pointer type.
32-
3331
- A data structure whose size is more than 8 bytes and contains no pointers.
34-
35-
- A buffer allocated by using the [_alloca](../../c-runtime-library/reference/alloca.md) function.
36-
32+
- A buffer allocated by using the [`_alloca`](../../c-runtime-library/reference/alloca.md) function.
3733
- Any class or structure that contains a GS buffer.
3834

3935
For example, the following statements declare GS buffers.
@@ -57,16 +53,14 @@ struct { int a; int b; };
5753

5854
## Initialize the Security Cookie
5955

60-
The **/GS** compiler option requires that the security cookie be initialized before any function that uses the cookie is run. The security cookie must be initialized immediately on entry to an EXE or DLL. This is done automatically if you use the default VCRuntime entry points: mainCRTStartup, wmainCRTStartup, WinMainCRTStartup, wWinMainCRTStartup, or _DllMainCRTStartup. If you use an alternate entry point, you must manually initialize the security cookie by calling [__security_init_cookie](../../c-runtime-library/reference/security-init-cookie.md).
56+
The **/GS** compiler option requires that the security cookie be initialized before any function that uses the cookie is run. The security cookie must be initialized immediately on entry to an EXE or DLL. This is done automatically if you use the default VCRuntime entry points: `mainCRTStartup`, `wmainCRTStartup`, `WinMainCRTStartup`, `wWinMainCRTStartup`, or `_DllMainCRTStartup`. If you use an alternate entry point, you must manually initialize the security cookie by calling [`__security_init_cookie`](../../c-runtime-library/reference/security-init-cookie.md).
6157

6258
## What Is Protected
6359

6460
The **/GS** compiler option protects the following items:
6561

6662
- The return address of a function call.
67-
6863
- The address of an exception handler for a function.
69-
7064
- Vulnerable function parameters.
7165

7266
On all platforms, **/GS** attempts to detect buffer overruns into the return address. Buffer overruns are more easily exploited on platforms such as x86 and x64, which use calling conventions that store the return address of a function call on the stack.
@@ -80,15 +74,10 @@ A vulnerable parameter is allocated before the cookie and local variables. A buf
8074
The compiler does not make copies of vulnerable parameters in the following situations:
8175

8276
- Functions that do not contain a GS buffer.
83-
84-
- Optimizations ([/O options](o-options-optimize-code.md)) are not enabled.
85-
77+
- Optimizations ([`/O` options](o-options-optimize-code.md)) are not enabled.
8678
- Functions that have a variable argument list (...).
87-
8879
- Functions that are marked with [naked](../../cpp/naked-cpp.md).
89-
9080
- Functions that contain inline assembly code in the first statement.
91-
9281
- A parameter is used only in ways that are less likely to be exploitable in the event of a buffer overrun.
9382

9483
## What Is Not Protected
@@ -100,9 +89,7 @@ Even if you use **/GS**, always try to write secure code that has no buffer over
10089
### To set this compiler option in Visual Studio
10190

10291
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).
103-
10492
1. Select the **Configuration Properties** > **C/C++** > **Code Generation** property page.
105-
10693
1. Modify the **Buffer Security Check** property.
10794

10895
### To set this compiler option programmatically
@@ -138,5 +125,5 @@ int main() {
138125
139126
## See also
140127
141-
[MSVC Compiler Options](compiler-options.md)<br/>
128+
[MSVC Compiler Options](compiler-options.md)\
142129
[MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md)

docs/c-runtime-library/reference/atanh-atanhf-atanhl.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,13 @@
11
---
22
title: "atanh, atanhf, atanhl"
33
description: "API reference for atanh, atanhf, and atanhl; which calculate the inverse hyperbolic tangent of a floating-point value."
4-
ms.date: "08/31/2020"
4+
ms.date: 08/31/2020
55
api_name: ["atanhl", "atanhf", "atanh", "_o_atanh", "_o_atanhf", "_o_atanhl"]
66
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"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["atanhl", "atanhf", "atanh"]
10-
helpviewer_keywords: ["atanhf function", "atanhl function", "atanh funciton"]
11-
ms.assetid: 83a43b5b-2580-4461-854f-dc84236d9f32
10+
helpviewer_keywords: ["atanhf function", "atanhl function", "atanh function"]
1211
---
1312
# `atanh`, `atanhf`, `atanhl`
1413

docs/c-runtime-library/reference/mbrtowc.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,13 @@
11
---
2-
description: "Learn more about: mbrtowc"
32
title: "mbrtowc"
4-
ms.date: "4/2/2020"
3+
description: "Learn more about: mbrtowc"
4+
ms.date: 4/2/2020
55
api_name: ["mbrtowc", "_o_mbrtowc"]
66
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"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["mbrtowc"]
1010
helpviewer_keywords: ["mbrtowc function"]
11-
ms.assetid: a1e87fcc-6de0-4ca1-bf26-508d28490286
1211
---
1312
# `mbrtowc`
1413

@@ -100,7 +99,7 @@ int Sample(char* szIn, wchar_t* wcOut, int nMax)
10099
szLocal = setlocale(LC_ALL, "French_Canada.1252");
101100
if (!szLocal)
102101
{
103-
printf("The fuction setlocale(LC_ALL, \"French_Canada.1252\") failed!\n");
102+
printf("The function setlocale(LC_ALL, \"French_Canada.1252\") failed!\n");
104103
return 1;
105104
}
106105

@@ -110,7 +109,7 @@ int Sample(char* szIn, wchar_t* wcOut, int nMax)
110109
// from a previous call to setlocale.
111110
if (_setmbcp(_MB_CP_SBCS) == -1)
112111
{
113-
printf("The fuction _setmbcp(_MB_CP_SBCS) failed!");
112+
printf("The function _setmbcp(_MB_CP_SBCS) failed!");
114113
return 1;
115114
}
116115

docs/c-runtime-library/reference/strtoimax-strtoimax-l-wcstoimax-wcstoimax-l.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,13 @@
11
---
2-
description: "Learn more about: strtoimax, _strtoimax_l, wcstoimax, _wcstoimax_l"
32
title: "strtoimax, _strtoimax_l, wcstoimax, _wcstoimax_l"
4-
ms.date: "11/04/2016"
3+
description: "Learn more about: strtoimax, _strtoimax_l, wcstoimax, _wcstoimax_l"
4+
ms.date: 11/04/2016
55
api_name: ["wcstoimax", "_wcstoimax_l", "_strtoimax_l", "strtoimax"]
66
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"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["wcstoimax", "_tcstoimax", "strtoimax", "_wcstoimax_l", "_strtoimax_l", "_tcstoimax_l"]
10-
helpviewer_keywords: ["strtoimax funciton", "conversion functions", "_strtoimax_l function", "_wcstoimax_l function", "wcstoimax function"]
11-
ms.assetid: 4530d3dc-aaac-4a76-b7cf-29ae3c98d0ae
10+
helpviewer_keywords: ["strtoimax function", "conversion functions", "_strtoimax_l function", "_wcstoimax_l function", "wcstoimax function"]
1211
---
1312
# `strtoimax`, `_strtoimax_l`, `wcstoimax`, `_wcstoimax_l`
1413

docs/code-quality/c28310.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
description: "Learn more about: Warning C28310"
32
title: Warning C28310
3+
description: "Learn more about: Warning C28310"
44
ms.date: 11/04/2016
55
f1_keywords: ["C28310"]
6-
ms.assetid: 51054ca8-01b6-454b-9853-f05f1c817b18
6+
helpviewer_keywords: ["C28310"]
77
---
88
# Warning C28310
99

docs/code-quality/c28311.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
description: "Learn more about: Warning C28311"
32
title: Warning C28311
3+
description: "Learn more about: Warning C28311"
44
ms.date: 11/04/2016
55
f1_keywords: ["C28311"]
6-
ms.assetid: 2c76e07a-4418-40ef-8a77-c62774bc3677
6+
helpviewer_keywords: ["C28311"]
77
---
88
# Warning C28311
99

docs/code-quality/c28312.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
description: "Learn more about: Warning C28312"
32
title: Warning C28312
3+
description: "Learn more about: Warning C28312"
44
ms.date: 11/04/2016
55
f1_keywords: ["C28312"]
6-
ms.assetid: 19828546-33c9-4373-b7df-2a362ca12637
6+
helpviewer_keywords: ["C28312"]
77
---
88
# Warning C28312
99

0 commit comments

Comments
 (0)