1 out of 2 rated this helpful - Rate this topic

StrFormatByteSizeA function

Applies to: desktop apps only

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 from StrFormatByteSizeW in one parameter type.

Syntax

Copy

PSTR StrFormatByteSizeA(
  DWORD dw,
  __out  PSTR pszBuf,
  UINT cchBuf
);

Parameters

dw

Type: DWORD

The numeric value to be converted.

pszBuf [out]

Type: PSTR

A pointer to a buffer that receives the converted string.

cchBuf

Type: UINT

The size of pszBuf, in characters.

Return value

Type: PSTR

Returns the address of the converted string, or NULL if the conversion fails.

Remarks

The first parameter of this function has a different type 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 use StrFormatByteSizeW explicitly.

Examples