Funzione StrFormatByteSizeW (shlwapi.h)

Articolo
11/20/2024

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 viene restituita 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 non riesce.

Osservazioni

Il primo parametro di questa funzione ha 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 a un 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 4.71 o successiva)

Vedere anche

StrFormatByteSize64

StrFormatByteSizeA

StrFormatByteSizeEx

Condividi tramite