Skip to content

Commit 98ff9e9

Browse files
Merge pull request #5073 from MicrosoftDocs/main638578712661120418sync_temp
For protected branch, push strategy should use PR and merge to target branch method to work around git push error
2 parents d995c11 + ebc1bd4 commit 98ff9e9

File tree

4 files changed

+84
-97
lines changed

4 files changed

+84
-97
lines changed

docs/c-runtime-library/reference/findfirst-functions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ intptr_t _wfindfirst64i32(
7272
Target file specification (can include wildcard characters).
7373

7474
*`fileinfo`*\
75-
File information buffer.
75+
File information buffer. For more information about the `fileinfo` structs, see the Remarks in [Filename search functions](../filename-search-functions.md) and see [Data type mappings](../data-type-mappings.md). The structs are defined in the same header file as the function that uses them as a parameter.
7676

7777
## Return value
7878

@@ -101,7 +101,7 @@ These functions use various forms of the **`_finddata_t`** structure for the *`f
101101

102102
The variations that use a 64-bit time type enable file-creation dates to be expressed up through 23:59:59, December 31, 3000, UTC. The ones that use 32-bit time types represent dates only through 23:59:59 January 18, 2038, UTC. Midnight, January 1, 1970, is the lower bound of the date range for all these functions.
103103

104-
Unless you have a specific reason to use the versions that specify the time size explicitly, use **`_findfirst`** or **`_wfindfirst`** or, if you need to support file sizes larger than 3 GB, use **`_findfirsti64`** or **`_wfindfirsti64`**. All these functions use the 64-bit time type. In earlier versions, these functions used a 32-bit time type. If this change is a breaking change for an application, you might define `_USE_32BIT_TIME_T` to revert to the old behavior. If `_USE_32BIT_TIME_T` is defined, **`_findfirst`**, **`_finfirsti64`**, and their corresponding Unicode versions use a 32-bit time.
104+
Unless you have a specific reason to use the versions that specify the time size explicitly, use **`_findfirst`** or **`_wfindfirst`** or, if you need to support file sizes larger than 3 GB, use **`_findfirsti64`** or **`_wfindfirsti64`**. All these functions use the 64-bit time type. In earlier versions, these functions used a 32-bit time type. If this change is a breaking change for an application, you might define `_USE_32BIT_TIME_T` to revert to the old behavior. If `_USE_32BIT_TIME_T` is defined, **`_findfirst`**, **`_findfirsti64`**, and their corresponding Unicode versions use a 32-bit time.
105105

106106
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).
107107

docs/c-runtime-library/reference/msize-dbg.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,6 @@ api_type: ["DLLExport"]
88
topic_type: ["apiref"]
99
f1_keywords: ["_msize_dbg", "msize_dbg"]
1010
helpviewer_keywords: ["memory blocks", "_msize_dbg function", "msize_dbg function"]
11-
ms.assetid: a333f4b6-f8a2-4e61-bb69-cb34063b8cef
1211
---
1312
# `_msize_dbg`
1413

@@ -41,13 +40,13 @@ On successful completion, **`_msize_dbg`** returns the size (in bytes) of the sp
4140

4241
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).
4342

44-
This function validates its parameter. If *`memblock`* is a null pointer, **`_msize_dbg`** invokes an invalid parameter handler, as described in [Parameter validation](../parameter-validation.md). If the error is handled, the function sets `errno` to `EINVAL` and returns -1.
43+
This function validates its parameter. If *`memblock`* is a null pointer, **`_msize_dbg`** invokes an invalid parameter handler, as described in [Parameter validation](../parameter-validation.md). If the error is handled, the function sets `errno` to `EINVAL` and returns -1 (18,446,744,073,709,551,615 unsigned).
4544

4645
## Requirements
4746

4847
| Routine | Required header |
4948
|---|---|
50-
| **`_msize_dbg`** | \<crtdbg.h> |
49+
| **`_msize_dbg`** | `<crtdbg.h>` |
5150

5251
For more compatibility information, see [Compatibility](../compatibility.md).
5352

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
description: "Learn more about: _msize"
33
title: "_msize"
4-
ms.date: "4/2/2020"
4+
ms.date: 07/26/2024
55
api_name: ["_msize", "_o__msize"]
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-heap-l1-1-0.dll"]
77
api_type: ["DLLExport"]
@@ -36,7 +36,7 @@ The **`_msize`** function returns the size, in bytes, of the memory block alloca
3636

3737
When the application is linked with a debug version of the C run-time libraries, **`_msize`** resolves to [`_msize_dbg`](msize-dbg.md). For more information about how the heap is managed during the debugging process, see [The CRT debug heap](../crt-debug-heap-details.md).
3838

39-
This function validates its parameter. If *`memblock`* is a `NULL` pointer, **`_msize`** invokes an invalid parameter handler, as described in [Parameter validation](../parameter-validation.md). If the error is handled, the function sets `errno` to `EINVAL` and returns -1.
39+
This function validates its parameter. If *`memblock`* is a `NULL` pointer, **`_msize`** invokes an invalid parameter handler, as described in [Parameter validation](../parameter-validation.md). If the error is handled, the function sets `errno` to `EINVAL` and returns -1 (18,446,744,073,709,551,615 unsigned).
4040

4141
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).
4242

0 commit comments

Comments
 (0)