Export (0) Print
Expand All
0 out of 1 rated this helpful - Rate this topic

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

Syntax


PWSTR StrFormatByteSizeW(
  LONGLONG qdw,
  _Out_  PWSTR pszBuf,
  UINT cchBuf
);

Parameters

qdw

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.

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 use StrFormatByteSizeW explicitly.

The following table illustrates how this function converts a numeric value into a text string.

Numeric valueText string
532532 bytes
13401.30 KB
2350622.9 KB
24000162.28 MB
24000000002.23 GB

 

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Shlwapi.h

Library

Shlwapi.lib

DLL

Shlwapi.dll (version 4.71 or later)

Unicode and ANSI names

StrFormatByteSizeW (Unicode)

See also

StrFormatByteSize64
StrFormatByteSizeEx
StrFormatByteSizeA

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.