Função StrFormatByteSize64A (shlwapi.h)

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.

Requisitos

Confira também

StrFormatByteSizeA

StrFormatByteSizeW