Partager via


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 retournée

Type : PTSTR

Retourne un pointeur vers la chaîne convertie, ou NULL si la conversion échoue.

Remarques

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.

Notes

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. 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

   
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)

Voir aussi

StrFormatByteSizeA

StrFormatByteSizeW