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)

Consulte también

StrFormatByteSize64

StrFormatByteSizeA

StrFormatByteSizeW