Funzione StrFormatByteSizeEx (shlwapi.h)
Converte un valore numerico in una stringa che rappresenta il numero in byte, kilobyte, megabyte o gigabyte, a seconda delle dimensioni. Estende StrFormatByteSizeW offrendo l'opzione di arrotondamento alla cifra visualizzata più vicina o per eliminare cifre non riprodotte.
Sintassi
LWSTDAPI StrFormatByteSizeEx(
ULONGLONG ull,
SFBS_FLAGS flags,
[out] PWSTR pszBuf,
UINT cchBuf
);
Parametri
ull
Tipo: ULONGLONG
Valore numerico da convertire.
flags
Tipo: SFBS_FLAGS
Uno dei valori di enumerazione SFBS_FLAGS che specifica se arrotondare o troncare cifre non riprodotte. Questo valore non può essere NULL.
[out] pszBuf
Tipo: PWSTR
Puntatore a un buffer che riceve la stringa convertita.
cchBuf
Tipo: UINT
Dimensioni del buffer a cui punta pszBuf, in caratteri.
Valore restituito
Tipo: HRESULT
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Nella tabella seguente viene illustrato come questa funzione converte un valore numerico in una stringa di testo in relazione al flag passato.
| Valore numerico | Flag | Stringa di testo |
|---|---|---|
| 2147483647 | SFBS_FLAGS_ROUND_TO_NEAREST_DISPLAYED_DIGIT | 2,00 GB |
| 2147483647 | SFBS_FLAGS_TRUNCATE_UNDISPLAYED_DECIMAL_DIGITS | 1,99 GB |
In Windows 10 le dimensioni vengono segnalate in base 10 anziché in base 2. Ad esempio, 1 KB è 1000 byte anziché 1024.
Requisiti
| Client minimo supportato | Windows Vista con SP1 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | shlwapi.h |
| Libreria | Shlwapi.lib |
| DLL | Shlwapi.dll (versione 6.0 o successiva) |