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.
LWSTDAPI StrFormatByteSizeEx(
ULONGLONG ull,
SFBS_FLAGS flags,
[out] PWSTR pszBuf,
UINT cchBuf
);
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.
Type : HRESULT
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
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.
| 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) |