StrFormatKBSizeA, fonction (shlwapi.h)
Convertit une valeur numérique en chaîne qui représente le nombre exprimé sous forme de valeur de taille en kilo-octets.
Syntaxe
PSTR StrFormatKBSizeA(
LONGLONG qdw,
[out] PSTR pszBuf,
UINT cchBuf
);
Paramètres
qdw
Type : LONGLONG
Valeur numérique à convertir.
[out] pszBuf
Type : PTSTR
Pointeur vers une mémoire tampon qui, lorsque cette fonction retourne correctement, reçoit le nombre converti.
cchBuf
Type : uiNT
Taille de pszBuf, en caractères.
Valeur de retour
Type : PTSTR
Retourne un pointeur vers la chaîne convertie, ou NULL en cas d’échec de la conversion.
Remarques
Dans Windows 10, la taille est signalée dans la base 10 plutôt que dans la base 2. Par exemple, 1 Ko est de 1 000 octets plutôt que 1024.
Note
L’en-tête shlwapi.h définit StrFormatKBSize 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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel, Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | shlwapi.h |
| bibliothèque | Shlwapi.lib |
| DLL | Shlwapi.dll (version 5.0 ou ultérieure) |