1.
StrFormatKBSize function
Converts a numeric value into a string that represents the number expressed as a size value in kilobytes.
Syntax
PTSTR StrFormatKBSize( LONGLONG qdw, _Out_ PTSTR pszBuf, UINT cchBuf );
Parameters
-
qdw
-
Type: LONGLONG
The numeric value to be converted.
pszBuf [out]
-
Type: PTSTR
A pointer to a buffer that, when this function returns successfully, receives the converted number.
cchBuf
-
Type: UINT
The size of pszBuf, in characters.
Return value
Type: PTSTR
Returns a pointer to the converted string, or NULL if the conversion fails.
Requirements
Minimum supported client | Windows 2000 Professional, Windows XP [desktop apps only] |
---|---|
Minimum supported server | Windows 2000 Server [desktop apps only] |
Header |
|
Library |
|
DLL |
|
Unicode and ANSI names | StrFormatKBSizeW (Unicode) and StrFormatKBSizeA (ANSI) |
See also
-
StrFormatByteSizeA
StrFormatByteSizeW
-
Type: LONGLONG
The numeric value to be converted.
pszBuf [out]
-
Type: PWSTR
A pointer to a buffer that, when this function returns successfully, receives the converted number.
cchBuf
-
Type: UINT
The size of the buffer pointed to by pszBuf, in characters.
-
Type: LONGLONG
The numeric value to be converted.
pszBuf [out]
-
Type: PSTR
A pointer to a buffer that, when this function returns successfully, receives the converted number.
cchBuf
-
Type: UINT
The size of the buffer pointed to by pszBuf, in characters.
StrFormatByteSizeW function
Converts a numeric value into a string that represents the number expressed as a size value in bytes, kilobytes, megabytes, or gigabytes, depending on the size. Differs fromStrFormatByteSizeA in one parameter type.
Syntax
PWSTR StrFormatByteSizeW( LONGLONG qdw, _Out_ PWSTR pszBuf, UINT cchBuf );
Parameters
-
qdw
Return value
Type: PWSTR
Returns a pointer to the converted string, or NULL if the conversion fails.
Remarks
The first parameter of this function has different types for the ANSI and Unicode versions. If your numeric value is a DWORD, you can use StrFormatByteSize with text macros for both cases. The compiler will cast the numerical value to a LONGLONG for the Unicode case. If your numerical value is a LONGLONG, you should useStrFormatByteSizeW explicitly.
The following table illustrates how this function converts a numeric value into a text string.
Numeric value | Text string |
---|---|
532 | 532 bytes |
1340 | 1.30 KB |
23506 | 22.9 KB |
2400016 | 2.28 MB |
2400000000 | 2.23 GB |
Requirements
Minimum supported client | Windows 2000 Professional, Windows XP [desktop apps only] |
---|---|
Minimum supported server | Windows 2000 Server [desktop apps only] |
Header |
|
Library |
|
DLL |
|
Unicode and ANSI names | StrFormatByteSizeW (Unicode) |
See also
StrFormatByteSize64 function
Converts a numeric value into a string that represents the number expressed as a size value in bytes, kilobytes, megabytes, or gigabytes, depending on the size.
Syntax
PSTR StrFormatByteSize64( LONGLONG qdw, _Out_ PSTR pszBuf, UINT cchBuf );
Parameters
-
qdw
Return value
Type: PSTR
Returns a pointer to the converted string, or NULL if the conversion fails.
Remarks
StrFormatByteSize64 can be used for either ANSI or Unicode characters. However, while StrFormatByteSize64A can be called directly, StrFormatByteSize64W is not defined. When StrFormatByteSize64 is called with a Unicode value, StrFormatByteSizeW is used.
The following table illustrates how this function converts a numeric value into a text string.
Numeric value | Text string |
---|---|
532 | 532 bytes |
1340 | 1.30 KB |
23506 | 22.9 KB |
2400016 | 2.28 MB |
2400000000 | 2.23 GB |
Requirements
Minimum supported client | Windows 2000 Professional, Windows XP [desktop apps only] |
---|---|
Minimum supported server | Windows 2000 Server [desktop apps only] |
Header |
|
Library |
|
DLL |
|
Unicode and ANSI names | StrFormatByteSize64A (ANSI) |
See also
Send comments about this topic to Microsoft
Build date: 11/28/2012