Funzione StrFormatByteSize64A (shlwapi.h)

Articolo
03/15/2023

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)

Vedi anche

StrFormatByteSizeA

StrFormatByteSizeW

Share via