Funzione StrFormatByteSizeA (shlwapi.h)

Converte un valore numerico in una stringa che rappresenta il numero espresso come valore di dimensione in byte, kilobyte, megabyte o gigabyte, a seconda delle dimensioni. Differisce da StrFormatByteSizeW in un tipo di parametro.

Sintassi

PSTR StrFormatByteSizeA(
        DWORD dw,
  [out] PSTR  pszBuf,
        UINT  cchBuf
);

Parametri

dw

Tipo: DWORD

Valore numerico da convertire.

[out] pszBuf

Tipo: PSTR

Puntatore a un buffer che riceve la stringa convertita.

cchBuf

Tipo: UINT

Dimensioni del buffer a cui punta pszBuf, in caratteri.

Valore restituito

Tipo: PSTR

Restituisce un puntatore alla stringa convertita o NULL se la conversione ha esito negativo.

Commenti

Il primo parametro di questa funzione ha un tipo diverso per le versioni ANSI e Unicode. Se il valore numerico è un DWORD, è possibile usare StrFormatByteSize con macro di testo per entrambi i casi. Il compilatore eseguirà il cast del valore numerico in longlong per il caso Unicode. Se il valore numerico è un LONGLONG, è consigliabile usare StrFormatByteSizeW in modo esplicito.

In Windows 10 le dimensioni vengono segnalate in base 10 anziché in base 2. Ad esempio, 1 KB è 1000 byte anziché 1024.

Nella tabella seguente viene illustrato come questa funzione converte un valore numerico in una stringa di testo.

Valore numerico	Stringa di testo
532	532 byte
1340	1.30 KB
23506	22.9 KB
2400016	2,28 MB
2400000000	2,23 GB

 

Nota

L'intestazione shlwapi.h definisce StrFormatByteSize come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 4.71 o successiva)

Vedi anche

StrFormatByteSize64

StrFormatByteSizeEx

StrFormatByteSizeW