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é.
| Valeur numérique | Indicateur | Chaîne de texte |
|---|---|---|
| 2147483647 | SFBS_FLAGS_ROUND_TO_NEAREST_DISPLAYED_DIGIT | 2,00 Go |
| 2147483647 | SFBS_FLAGS_TRUNCATE_UNDISPLAYED_DECIMAL_DIGITS | 1,99 Go |
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
| Client minimal pris en charge | Windows Vista avec SP1 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shlwapi.h |
| Bibliothèque | Shlwapi.lib |
| DLL | Shlwapi.dll (version 6.0 ou ultérieure) |