Поделиться через

Функция StrFormatByteSize64A (shlwapi.h)

  • Статья

Преобразует числовое значение в строку, представляющую число, выраженное в виде значения размера в байтах, килобайтах, мегабайтах или гигабайтах в зависимости от размера.

Синтаксис

PSTR StrFormatByteSize64A(
        LONGLONG qdw,
  [out] PSTR     pszBuf,
        UINT     cchBuf
);

Параметры

qdw

Тип: LONGLONG

Числовое значение, которое необходимо преобразовать.

[out] pszBuf

Тип: PSTR

Указатель на буфер, который при успешном возвращении этой функции получает преобразованное число.

cchBuf

Тип: UINT

Размер буфера, на который указывает pszBuf, в символах.

Возвращаемое значение

Тип: PSTR

Возвращает указатель на преобразованную строку или значение NULL в случае сбоя преобразования.

Комментарии

StrFormatByteSize64 можно использовать для символов ANSI или Юникода. Однако, хотя StrFormatByteSize64A можно вызвать напрямую, StrFormatByteSize64W не определен. При вызове StrFormatByteSize64 со значением Юникода используется StrFormatByteSizeW .

В Windows 10 размер указывается в базе 10, а не в базе 2. Например, 1 КБ — это 1000 байт, а не 1024.

В следующей таблице показано, как эта функция преобразует числовое значение в текстовую строку.

Числовое значение Текстовая строка
532 532 байта
1340 1,30 КБ
23506 23,5 КБ
2400016 2,40 МБ
2400000000 2,4 ГБ

Требования

   
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header shlwapi.h
Библиотека Shlwapi.lib
DLL Shlwapi.dll (версия 5.0 или более поздняя)

См. также раздел

StrFormatByteSizea

StrFormatByteSizeW