Função StrFormatKBSizeA (shlwapi.h)
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 de pszBuf, em caracteres.
Valor de retorno
Tipo: PTSTR
Retorna um ponteiro para a cadeia de caracteres convertida ou NULL se a conversão falhar.
Observações
No Windows 10, o tamanho é relatado na base 10 em vez da base 2. Por exemplo, 1 KB é 1000 bytes em vez de 1024.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows 2000 Server [somente aplicativos da área de trabalho] |
| da Plataforma de Destino |
Windows |
| cabeçalho | shlwapi.h |
| biblioteca | Shlwapi.lib |
| de DLL |
Shlwapi.dll (versão 5.0 ou posterior) |