StrFormatByteSize64A, 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.
Syntaxe
PSTR StrFormatByteSize64A(
LONGLONG qdw,
[out] PSTR pszBuf,
UINT cchBuf
);
Paramètres
qdw
Type : LONGLONG
Valeur numérique à convertir.
[out] pszBuf
Type : PSTR
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 : PSTR
Retourne un pointeur vers la chaîne convertie, ou NULL si la conversion échoue.
Remarques
StrFormatByteSize64 peut être utilisé pour les caractères ANSI ou Unicode. Toutefois, alors que StrFormatByteSize64A peut être appelé directement, StrFormatByteSize64W n’est pas défini. Lorsque StrFormatByteSize64 est appelé avec une valeur Unicode, StrFormatByteSizeW est utilisé.
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 | 23,5 Ko |
| 2400016 | 2,40 Mo |
| 2400000000 | 2,4 Go |
Configuration requise
| 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 5.0 ou ultérieure) |