StrFormatByteSizeW, fonction (shlwapi.h)
Convertit une valeur numérique en chaîne qui représente le nombre exprimé sous forme de valeur de taille en octets, kilo-octets, mégaoctets ou gigaoctets, selon la taille. Diffère de StrFormatByteSizeA dans un type de paramètre.
Syntaxe
PWSTR StrFormatByteSizeW(
LONGLONG qdw,
[out] PWSTR pszBuf,
UINT cchBuf
);
Paramètres
qdw
Type : LONGLONG
Valeur numérique à convertir.
[out] pszBuf
Type : PWSTR
Pointeur vers une mémoire tampon qui, lorsque cette fonction retourne correctement, reçoit le nombre converti.
cchBuf
Type : UINT
Taille de la mémoire tampon pointée vers pszBuf, en caractères.
Valeur retournée
Type : PWSTR
Retourne un pointeur vers la chaîne convertie, ou NULL si la conversion échoue.
Remarques
Le premier paramètre de cette fonction a différents types pour les versions ANSI et Unicode. Si votre valeur numérique est un DWORD, vous pouvez utiliser StrFormatByteSize avec des macros de texte dans les deux cas. Le compilateur caste la valeur numérique en longlong pour le cas Unicode. Si votre valeur numérique est un LONGLONG, vous devez utiliser StrFormatByteSizeW explicitement.
Dans Windows 10, la taille est indiquée en base 10 plutôt qu’en base 2. Par exemple, 1 Ko correspond à 1 000 octets au lieu de 1 024.
Le tableau suivant illustre la façon dont cette fonction convertit une valeur numérique en chaîne de texte.
| Valeur numérique | Chaîne de texte |
|---|---|
| 532 | 532 octets |
| 1340 | 1,30 Ko |
| 23506 | 22,9 Ko |
| 2400016 | 2,28 Mo |
| 2400000000 | 2,23 Go |
Notes
L’en-tête shlwapi.h définit StrFormatByteSize en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel, Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | shlwapi.h |
| Bibliothèque | Shlwapi.lib |
| DLL | Shlwapi.dll (version 4.71 ou ultérieure) |