StrFormatByteSizeEx 函式 (shlwapi.h)

根據大小，將數值轉換成字串，代表以位元組、KB、MB 或 GB 為單位的數位。藉由提供選項來舍入到最接近的顯示數位，或捨棄未顯示的數位，以擴充 StrFormatByteSizeW 。

語法

LWSTDAPI StrFormatByteSizeEx(
        ULONGLONG  ull,
        SFBS_FLAGS flags,
  [out] PWSTR      pszBuf,
        UINT       cchBuf
);

ull

類型： ULONGLONG

要轉換的數值。

flags

類型： SFBS_FLAGS

其中一個 SFBS_FLAGS 列舉值，指定是否要舍入或截斷未顯示的數位。這個值不可以是 Null。

[out] pszBuf

類型： PWSTR

接收已轉換字串之緩衝區的指標。

cchBuf

類型： UINT

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

類型： HRESULT

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

下表說明此函式如何將數值轉換成與傳遞旗標相關的文字字串。

數值	旗標	文字字串
2147483647	SFBS_FLAGS_ROUND_TO_NEAREST_DISPLAYED_DIGIT	2.00 GB
2147483647	SFBS_FLAGS_TRUNCATE_UNDISPLAYED_DECIMAL_DIGITS	1.99 GB

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