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 或更高版本)

另请参阅

StrFormatByteSizeA

StrFormatByteSizeW