Função StrFormatKBSizeA (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 quilobytes.

Sintaxe

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

Parâmetros

qdw

Tipo: LONGLONG

O valor numérico a ser convertido.

[out] pszBuf

Tipo: PTSTR

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

cchBuf

Tipo: UINT

O tamanho do pszBuf, em caracteres.

Valor retornado

Tipo: PTSTR

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

Comentários

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

Observação

O cabeçalho shlwapi.h define StrFormatKBSize como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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