Función StrFormatByteSize64A (shlwapi.h)

Convierte un valor numérico en una cadena que representa el número expresado como un valor de tamaño en bytes, kilobytes, megabytes o gigabytes, según el tamaño.

Sintaxis

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

Parámetros

qdw

Tipo: LONGLONG

Valor numérico que se va a convertir.

[out] pszBuf

Tipo: PSTR

Puntero a un búfer que, cuando esta función devuelve correctamente, recibe el número convertido.

cchBuf

Tipo: UINT

Tamaño del búfer al que apunta pszBuf, en caracteres.

Valor devuelto

Tipo: PSTR

Devuelve un puntero a la cadena convertida o NULL si se produce un error en la conversión.

Comentarios

StrFormatByteSize64 se puede usar para caracteres ANSI o Unicode. Sin embargo, aunque se puede llamar directamente a StrFormatByteSize64A , no se define StrFormatByteSize64W . Cuando se llama a StrFormatByteSize64 con un valor Unicode, se usa StrFormatByteSizeW .

En Windows 10, el tamaño se notifica en base 10 en lugar de en base 2. Por ejemplo, 1 KB es de 1000 bytes en lugar de 1024.

En la tabla siguiente se muestra cómo esta función convierte un valor numérico en una cadena de texto.

Requisitos

Consulte también

StrFormatByteSizeA

StrFormatByteSizeW