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