共用方式為


StrFormatByteSize64A 函式 (shlwapi.h)

根據大小,將數值轉換成字串,代表以位元組、KB、MB 或 GB 為單位的大小值表示的數位。

語法

PSTR StrFormatByteSize64A(
        LONGLONG qdw,
  [out] PSTR     pszBuf,
        UINT     cchBuf
);

參數

qdw

類型: LONGLONG

要轉換的數值。

[out] pszBuf

類型: PSTR

緩衝區的指標,當此函式成功傳回時,會收到已轉換的數位。

cchBuf

類型: UINT

pszBuf所指向的緩衝區大小,以字元為單位。

傳回值

類型: PSTR

傳回已轉換字串的指標,如果轉換失敗,則傳回 Null

備註

StrFormatByteSize64 可用於 ANSI 或 Unicode 字元。 不過,雖然可以直接呼叫 StrFormatByteSize64A ,但未定義 StrFormatByteSize64W 。 使用 Unicode 值呼叫 StrFormatByteSize64 時,會使用 StrFormatByteSizeW

在Windows 10中,大小會以基底 10 回報,而不是以基底 2 回報。 例如,1 KB 是 1000 個位元組,而不是 1024。

下表說明此函式如何將數值轉換成文字字串。

數值 文字字串
532 532 個位元組
1340 1.30 KB
23506 23.5 KB
2400016 2.40 MB
2400000000 2.4 GB

規格需求

   
最低支援的用戶端 Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 shlwapi.h
程式庫 Shlwapi.lib
Dll Shlwapi.dll (5.0 版或更新版本)

另請參閱

StrFormatByteSizeA

StrFormatByteSizeW