Funzione StrFormatByteSizeA (shlwapi.h)

Articolo
11/20/2024

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

Osservazioni

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 a un 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 4.71 o successiva)

Vedere anche

StrFormatByteSize64

StrFormatByteSizeEx

StrFormatByteSizeW

Condividi tramite