Share via

Função StrFormatByteSize64A (shlwapi.h)

  • Artigo

Converte um valor numérico em uma cadeia de caracteres que representa o número expresso como um valor de tamanho em bytes, quilobytes, megabytes ou gigabytes, dependendo do tamanho.

Sintaxe

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

Parâmetros

qdw

Tipo: LONGLONG

O valor numérico a ser convertido.

[out] pszBuf

Tipo: PSTR

Um ponteiro para um buffer que, quando essa função retorna com êxito, recebe o número convertido.

cchBuf

Tipo: UINT

O tamanho do buffer apontado por pszBuf, em caracteres.

Valor retornado

Tipo: PSTR

Retorna um ponteiro para a cadeia de caracteres convertida ou NULL se a conversão falhar.

Comentários

StrFormatByteSize64 pode ser usado para caracteres ANSI ou Unicode. No entanto, embora StrFormatByteSize64A possa ser chamado diretamente, StrFormatByteSize64W não está definido. Quando StrFormatByteSize64 é chamado com um valor Unicode, StrFormatByteSizeW é usado.

No Windows 10, o tamanho é relatado na base 10 em vez de na base 2. Por exemplo, 1 KB é 1000 bytes em vez de 1024.

A tabela a seguir ilustra como essa função converte um valor numérico em uma cadeia de caracteres de texto.

Valor numérico Cadeia de caracteres de texto
532 532 bytes
1340 1,30 KB
23506 23,5 KB
2400016 2,40 MB
2400000000 2,4 GB

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlwapi.h
Biblioteca Shlwapi.lib
DLL Shlwapi.dll (versão 5.0 ou posterior)

Confira também

StrFormatByteSizeA

StrFormatByteSizeW