StrFormatKBSizeW 函数 (shlwapi.h)
将数值转换为字符串,该字符串表示为以千字节为单位的大小值表示的数字。
语法
PWSTR StrFormatKBSizeW(
LONGLONG qdw,
[out] PWSTR pszBuf,
UINT cchBuf
);
参数
qdw
类型: LONGLONG
要转换的数值。
[out] pszBuf
类型: PTSTR
指向缓冲区的指针,当此函数成功返回时,该缓冲区接收转换后的数字。
cchBuf
类型: UINT
pszBuf 的大小(以字符为单位)。
返回值
类型: PTSTR
返回指向转换后的字符串的指针;如果转换失败,则返回 NULL 。
注解
在 Windows 10 中,大小以 10 而不是基 2 报告。 例如,1 KB 是 1000 字节,而不是 1024 字节。
注意
shlwapi.h 标头将 StrFormatKBSize 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版、Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | shlwapi.h |
Library | Shlwapi.lib |
DLL | Shlwapi.dll (5.0 或更高版本) |