MicrosoftDocs
diff --git a/‎docs/c-runtime-library/reference/getdiskfree.md
Lines changed: 44 additions & 98 deletions b/‎docs/c-runtime-library/reference/getdiskfree.md
Lines changed: 44 additions & 98 deletions
diff --git a/‎docs/c-runtime-library/scanf-type-field-characters.md
Lines changed: 2 additions & 2 deletions b/‎docs/c-runtime-library/scanf-type-field-characters.md
Lines changed: 2 additions & 2 deletions
@@ -1,18 +1,17 @@
 ---
 description: "Learn more about: _getdiskfree"
 title: "_getdiskfree"
-ms.date: "4/2/2020"
+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", "api-ms-win-crt-private-l1-1-0.dll"]
 api_type: ["DLLExport"]
 topic_type: ["apiref"]
 f1_keywords: ["getdiskfree", "_getdiskfree"]
 helpviewer_keywords: ["diskfree_t type", "_getdiskfree function", "_diskfree_t type", "disk size", "getdiskfree function"]
-ms.assetid: 47a3f6cf-4816-452a-8f3d-1c3ae02a0f2a
 ---
 # _getdiskfree
 
-Uses information about a disk drive to populate a **_diskfree_t** structure.
+Get information about a disk drive such as total clusters, available clusters, sectors per cluster, and bytes per sector.
 
 > [!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).
@@ -28,19 +27,19 @@ unsigned _getdiskfree(
 
 ### Parameters
 
-*drive*<br/>
+*`drive`*\
 The disk drive for which you want information.
 
-*driveinfo*<br/>
-A **_diskfree_t** structure that will be populated with information about the drive.
+*`driveinfo`*\
+A **`_diskfree_t`** structure that will be populated with information about the drive.
 
 ## Return Value
 
-If the function succeeds, the return value is zero. If the function fails, the return value is the error code. The value **errno** is set for any errors that are returned by the operating system. For more information about error conditions that are indicated by **errno**, see [errno Constants](../../c-runtime-library/errno-constants.md).
+If the function succeeds, the return value is zero. If the function fails, the return value is the error code. The value **`errno`** is set for any errors that are returned by the operating system. For more information about error conditions that are indicated by **`errno`**, see [`errno` constants](../../c-runtime-library/errno-constants.md).
 
 ## Remarks
 
-The **_diskfree_t** structure is defined in Direct.h.
+The **`_diskfree_t`** structure is defined in Direct.h.
 
 ```C
 struct _diskfree_t {
@@ -51,15 +50,15 @@ struct _diskfree_t {
 };
 ```
 
-This function validates its parameters. If the *driveinfo* pointer is **NULL** or *drive* specifies an invalid drive, this function invokes an invalid parameter handler, as described in [Parameter Validation](../../c-runtime-library/parameter-validation.md). If execution is allowed to continue, the function returns **EINVAL** and sets **errno** to **EINVAL**. Valid drives range from 0 to 26. A *drive* value of 0 specifies the current drive; thereafter, numbers map to letters of the English alphabet such that 1 indicates drive A, 3 indicates drive C, and so on.
+This function validates its parameters. If the *`driveinfo`* pointer is **`NULL`** or *`drive`* specifies an invalid drive, this function invokes an invalid parameter handler, as described in [Parameter Validation](../../c-runtime-library/parameter-validation.md). If execution is allowed to continue, the function returns **`EINVAL`** and sets **`errno`** to **`EINVAL`**. Valid drives range from 0 to 26. A *drive* value of 0 specifies the current drive; thereafter, numbers map to letters of the English alphabet such that 1 indicates drive A, 3 indicates drive C, and so on.
 
 By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](../global-state.md).
 
 ## Requirements
 
 |Routine|Required header|
 |-------------|---------------------|
-|**_getdiskfree**|\<direct.h>|
+|**`_getdiskfree`**|`<direct.h>`|
 
 For more compatibility information, see [Compatibility](../../c-runtime-library/compatibility.md).
 
@@ -71,100 +70,47 @@ For more compatibility information, see [Compatibility](../../c-runtime-library/
 #include <windows.h>
 #include <direct.h>
 #include <stdio.h>
-#include <tchar.h>
-
-TCHAR   g_szBorder[] = _T("======================================================================\n");
-TCHAR   g_szTitle1[] = _T("|DRIVE|TOTAL CLUSTERS|AVAIL CLUSTERS|SECTORS / CLUSTER|BYTES / SECTOR|\n");
-TCHAR   g_szTitle2[] = _T("|=====|==============|==============|=================|==============|\n");
-TCHAR   g_szLine[]   = _T("|  A: |              |              |                 |              |\n");
-
-void utoiRightJustified(TCHAR* szLeft, TCHAR* szRight, unsigned uVal);
-
-int main(int argc, char* argv[]) {
-   TCHAR szMsg[4200];
-   struct _diskfree_t df = {0};
-   ULONG uDriveMask = _getdrives();
-   unsigned uErr, uLen, uDrive;
-
-   printf(g_szBorder);
-   printf(g_szTitle1);
-   printf(g_szTitle2);
-
-   for (uDrive=1; uDrive<=26; ++uDrive) {
-      if (uDriveMask & 1) {
-         uErr = _getdiskfree(uDrive, &df);
-         memcpy(szMsg, g_szLine, sizeof(g_szLine));
-         szMsg[3] = uDrive + 'A' - 1;
-
-         if (uErr == 0) {
-            utoiRightJustified(szMsg+8,  szMsg+19, df.total_clusters);
-            utoiRightJustified(szMsg+23, szMsg+34, df.avail_clusters);
-            utoiRightJustified(szMsg+38, szMsg+52, df.sectors_per_cluster);
-            utoiRightJustified(szMsg+56, szMsg+67, df.bytes_per_sector);
-         }
-         else {
-            uLen = FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM, NULL,
-                            uErr, 0, szMsg+8, 4100, NULL);
-            szMsg[uLen+6] = ' ';
-            szMsg[uLen+7] = ' ';
-            szMsg[uLen+8] = ' ';
-         }
-
-         printf(szMsg);
-      }
-
-      uDriveMask >>= 1;
-   }
-
-   printf(g_szBorder);
-}
 
-void utoiRightJustified(TCHAR* szLeft, TCHAR* szRight, unsigned uVal) {
-   TCHAR* szCur = szRight;
-   int nComma = 0;
-
-   if (uVal) {
-      while (uVal && (szCur >= szLeft)) {
-         if   (nComma == 3) {
-            *szCur = ',';
-            nComma = 0;
-         }
-         else {
-            *szCur = (uVal % 10) | 0x30;
-            uVal /= 10;
-            ++nComma;
-         }
-
-         --szCur;
-      }
-   }
-   else {
-      *szCur = '0';
-      --szCur;
-   }
-
-   if (uVal) {
-      szCur = szLeft;
-
-      while   (szCur <= szRight) {
-         *szCur = '*';
-         ++szCur;
-      }
-   }
+int main(int argc, char* argv[]) 
+{
+    ULONG uDriveMask = _getdrives();
+
+    for (unsigned uDrive = 1; uDrive <= 26; ++uDrive) 
+    {
+        if (uDriveMask & 1)
+        {
+            struct _diskfree_t df = { 0 };
+            unsigned uErr = _getdiskfree(uDrive, &df);
+            printf("\nDrive: %c\n", uDrive + 'A' - 1);
+            
+            if (uErr == 0)
+            {
+                printf("\tTotal clusters:      %11u\n", df.total_clusters);
+                printf("\tAvailable clusters:  %11u\n", df.avail_clusters);
+                printf("\tSectors per cluster: %11u\n", df.sectors_per_cluster);
+                printf("\tBytes per sector:    %11u\n", df.bytes_per_sector);
+            }
+            else
+            {
+                WCHAR errMsg[80];
+                unsigned uLen = FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM, NULL,
+                    uErr, 0, errMsg, sizeof(errMsg), NULL);
+                printf("%S\n", errMsg);
+            }
+        }
+        uDriveMask >>= 1;
+    }
 }
 ```
 
 ```Output
-======================================================================
-|DRIVE|TOTAL CLUSTERS|AVAIL CLUSTERS|SECTORS / CLUSTER|BYTES / SECTOR|
-|=====|==============|==============|=================|==============|
-|  A: | The device is not ready.    |                 |              |
-|  C: |    4,721,093 |    3,778,303 |               8 |          512 |
-|  D: |    1,956,097 |    1,800,761 |               8 |          512 |
-|  E: | The device is not ready.    |                 |              |
-======================================================================
+Drive: C
+        Total clusters:        249754111
+        Available clusters:    160184686
+        Sectors per cluster:           8
+        Bytes per sector:            512
 ```
 
 ## See also
 
-[Directory Control](../../c-runtime-library/directory-control.md)<br/>
+[Directory Control](../../c-runtime-library/directory-control.md)
@@ -14,8 +14,8 @@ The `type` character is the only required format field; it appears after any opt
 
 |Character|Type of input expected|Type of argument|Size argument in secure version?|
 |---------------|----------------------------|----------------------|--------------------------------------|
-|`c`|Character. When used with `scanf` functions, specifies single-byte character; when used with `wscanf` functions, specifies wide character. White-space characters that are ordinarily skipped are read when `c` is specified. To read next non-white-space single-byte character, use `%1s`; to read next non-white-space wide character, use `%1ws`.|Pointer to **`char`** when used with `scanf` functions, pointer to **`wchar_t`** when used with `wscanf` functions.|Required. Size does not include space for a null terminator.|
-|`C`|Opposite size character. When used with `scanf` functions, specifies wide character; when used with `wscanf` functions, specifies single-byte character. White-space characters that are ordinarily skipped are read when `C` is specified. To read next non-white-space single-byte character, use `%1s`; to read next non-white-space wide character, use `%1ws`.|Pointer to **`wchar_t`** when used with `scanf` functions, pointer to **`char`** when used with `wscanf` functions.|Required. Size argument does not include space for a null terminator.|
+|`c`|Character. When used with `scanf` functions, specifies single-byte character; when used with `wscanf` functions, specifies wide character. White-space characters that are ordinarily skipped are read when `c` is specified. Unlike with other type fields, the field width specifier indicates the exact number of characters, not the maximum. To read next non-white-space single-byte character, use `%1s`; to read next non-white-space wide character, use `%1ws`.|Pointer to **`char`** when used with `scanf` functions, pointer to **`wchar_t`** when used with `wscanf` functions.|Required. Size does not include space for a null terminator.|
+|`C`|Opposite size character. When used with `scanf` functions, specifies wide character; when used with `wscanf` functions, specifies single-byte character. White-space characters that are ordinarily skipped are read when `C` is specified. Unlike with other type fields, the field width specifier indicates the exact number of characters, not the maximum. To read next non-white-space single-byte character, use `%1s`; to read next non-white-space wide character, use `%1ws`.|Pointer to **`wchar_t`** when used with `scanf` functions, pointer to **`char`** when used with `wscanf` functions.|Required. Size argument does not include space for a null terminator.|
 |`d`|Decimal integer.|Pointer to **`int`**.|No.|
 |`i`|An integer. Hexadecimal if the input string begins with "0x" or "0X", octal if the string begins with "0", otherwise decimal.|Pointer to **`int`**.|No.|
 |`o`|Octal integer.|Pointer to **`int`**.|No.|