Función StrFormatByteSizeEx (shlwapi.h)
Convierte un valor numérico en una cadena que representa el número en bytes, kilobytes, megabytes o gigabytes, según el tamaño. Extiende StrFormatByteSizeW al ofrecer la opción de redondear al dígito mostrado más cercano o descartar dígitos no reproducidos.
Sintaxis
LWSTDAPI StrFormatByteSizeEx(
ULONGLONG ull,
SFBS_FLAGS flags,
[out] PWSTR pszBuf,
UINT cchBuf
);
Parámetros
ull
Tipo: ULONGLONG
Valor numérico que se va a convertir.
flags
Tipo: SFBS_FLAGS
Uno de los SFBS_FLAGS valores de enumeración que especifica si se deben redondear o truncar dígitos no reproducidos. Este valor no puede ser NULL.
[out] pszBuf
Tipo: PWSTR
Puntero a un búfer que recibe la cadena convertida.
cchBuf
Tipo: UINT
Tamaño del búfer al que apunta pszBuf, en caracteres.
Valor devuelto
Tipo: HRESULT
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
En la tabla siguiente se muestra cómo esta función convierte un valor numérico en una cadena de texto en relación con la marca pasada.
| Valor numérico | Marca | Cadena de texto |
|---|---|---|
| 2147483647 | SFBS_FLAGS_ROUND_TO_NEAREST_DISPLAYED_DIGIT | 2,00 GB |
| 2147483647 | SFBS_FLAGS_TRUNCATE_UNDISPLAYED_DECIMAL_DIGITS | 1,99 GB |
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.
Requisitos
| Cliente mínimo compatible | Windows Vista con SP1 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shlwapi.h |
| Library | Shlwapi.lib |
| Archivo DLL | Shlwapi.dll (versión 6.0 o posterior) |