Funzione StrFormatByteSizeW (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 StrFormatByteSizeA in un tipo di parametro.

Sintassi

PWSTR StrFormatByteSizeW(
        LONGLONG qdw,
  [out] PWSTR    pszBuf,
        UINT     cchBuf
);

Parametri

qdw

Tipo: LONGLONG

Valore numerico da convertire.

[out] pszBuf

Tipo: PWSTR

Puntatore a un buffer che, quando questa funzione restituisce correttamente, riceve il numero convertito.

cchBuf

Tipo: UINT

Dimensioni del buffer a cui punta pszBuf, in caratteri.

Valore restituito

Tipo: PWSTR

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

Commenti

Il primo parametro di questa funzione include tipi diversi 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

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	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 4.71 o successiva)

Vedi anche

StrFormatByteSize64

StrFormatByteSizeA

StrFormatByteSizeEx