StrFormatKBSizeW 函数（shlwapi.h）

将数值转换为字符串，表示以 KB 为单位的大小值表示的数字。

语法

PWSTR StrFormatKBSizeW(
        LONGLONG qdw,
  [out] PWSTR    pszBuf,
        UINT     cchBuf
);

qdw

类型：LONGLONG

要转换的数值。

[out] pszBuf

类型：PTSTR

指向缓冲区的指针，当此函数成功返回时，将接收转换的数字。

cchBuf

类型：UINT

pszBuf的大小（以字符为单位）。

类型：PTSTR

返回指向转换后的字符串的指针，或 NULL（如果转换失败）。

在 Windows 10 中，大小以 base 10 而不是 base 2 报告。例如，1 KB 是 1000 字节而不是 1024。

注意

shlwapi.h 标头将 StrFormatKBSize 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求	价值
最低支持的客户端	Windows 2000 Professional、Windows XP [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	shlwapi.h
库	Shlwapi.lib
DLL	Shlwapi.dll （版本 5.0 或更高版本）