strFormatByteSize64A 函数 (shlwapi.h)
将数值转换为字符串,该字符串表示以大小值表示的数字(以字节、千字节、兆字节或千兆字节为单位),具体取决于大小。
语法
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 |
Library | Shlwapi.lib |
DLL | Shlwapi.dll (5.0 或更高版本) |