StrFormatByteSizeEx 함수(shlwapi.h)

숫자 값을 크기에 따라 바이트, 킬로바이트, 메가바이트 또는 기가바이트 단위의 숫자를 나타내는 문자열로 변환합니다. 표시된 가장 가까운 숫자로 반올림하거나 재생되지 않은 숫자를 삭제하는 옵션을 제공하여 StrFormatByteSizeW 를 확장합니다.

구문

LWSTDAPI StrFormatByteSizeEx(
        ULONGLONG  ull,
        SFBS_FLAGS flags,
  [out] PWSTR      pszBuf,
        UINT       cchBuf
);

ull

형식: ULONGLONG

변환할 숫자 값입니다.

flags

형식: SFBS_FLAGS

재생되지 않은 숫자를 반올림할지 여부를 지정하는 SFBS_FLAGS 열거형 값 중 하나입니다. 이 값은 NULL일 수 없습니다.

[out] pszBuf

형식: PWSTR

변환된 문자열을 수신하는 버퍼에 대한 포인터입니다.

cchBuf

형식: UINT

pszBuf가 가리키는 버퍼의 크기(문자)입니다.

형식: HRESULT

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

다음 표에서는 이 함수가 전달된 플래그와 관련하여 숫자 값을 텍스트 문자열로 변환하는 방법을 보여 줍니다.

숫자 값	플래그	텍스트 문자열
2147483647	SFBS_FLAGS_ROUND_TO_NEAREST_DISPLAYED_DIGIT	2.00GB
2147483647	SFBS_FLAGS_TRUNCATE_UNDISPLAYED_DECIMAL_DIGITS	1.99GB

Windows 10 크기는 base 2가 아닌 base 10으로 보고됩니다. 예를 들어 1KB는 1024가 아닌 1000바이트입니다.