Funzione StrFormatByteSize64A (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.
Sintassi
PSTR StrFormatByteSize64A(
LONGLONG qdw,
[out] PSTR pszBuf,
UINT cchBuf
);
Parametri
qdw
Tipo: LONGLONG
Valore numerico da convertire.
[out] pszBuf
Tipo: PSTR
Puntatore a un buffer che, quando questa funzione viene restituita correttamente, riceve il numero convertito.
cchBuf
Tipo: UINT
Dimensioni del buffer a cui punta pszBuf, in caratteri.
Valore restituito
Tipo: PSTR
Restituisce un puntatore alla stringa convertita oppure NULL se la conversione non riesce.
Commenti
StrFormatByteSize64 può essere usato per i caratteri ANSI o Unicode. Tuttavia, mentre StrFormatByteSize64A può essere chiamato direttamente, StrFormatByteSize64W non è definito. Quando StrFormatByteSize64 viene chiamato con un valore Unicode, viene usato StrFormatByteSizeW .
In Windows 10 le dimensioni vengono segnalate in base 10 anziché in base 2. Ad esempio, 1 KB è di 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 | 23,5 KB |
| 2400016 | 2,40 MB |
| 2400000000 | 2,4 GB |
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 5.0 o successiva) |