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.

In Windows 10 le dimensioni vengono segnalate in base 10 anziché in base 2. Ad esempio, 1 KB è 1000 byte anziché 1024.

Requisiti

Vedi anche

StrFormatByteSize64

StrFormatByteSizeA

StrFormatByteSizeW