Fonction StrFormatByteSizeEx (shlwapi.h)

Convertit une valeur numérique en chaîne qui représente le nombre en octets, kilo-octets, mégaoctets ou gigaoctets, selon la taille. Étend StrFormatByteSizeW en offrant la possibilité d’arrondir au chiffre affiché le plus proche ou d’ignorer les chiffres non affichés.

Syntaxe

LWSTDAPI StrFormatByteSizeEx(
        ULONGLONG  ull,
        SFBS_FLAGS flags,
  [out] PWSTR      pszBuf,
        UINT       cchBuf
);

Paramètres

ull

Type : ULONGLONG

Valeur numérique à convertir.

flags

Type : SFBS_FLAGS

L’une des valeurs d’énumération SFBS_FLAGS qui spécifie s’il faut arrondir ou tronquer des chiffres non filtrés. Cette valeur ne peut pas être NULL.

[out] pszBuf

Type : PWSTR

Pointeur vers une mémoire tampon qui reçoit la chaîne convertie.

cchBuf

Type : UINT

Taille de la mémoire tampon pointée vers pszBuf, en caractères.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le tableau suivant montre comment cette fonction convertit une valeur numérique en chaîne de texte par rapport à l’indicateur passé.

Dans Windows 10, la taille est signalée en base 10 plutôt qu’en base 2. Par exemple, 1 Ko correspond à 1 000 octets au lieu de 1 024.

Configuration requise

Voir aussi

StrFormatByteSize64

StrFormatByteSizeA

StrFormatByteSizeW