StrFormatByteSize64A 関数 (shlwapi.h)
サイズに応じて、数値をバイト、キロバイト、メガバイト、ギガバイト単位のサイズ値として表される数値を表す文字列に変換します。
構文
PSTR StrFormatByteSize64A(
LONGLONG qdw,
[out] PSTR pszBuf,
UINT cchBuf
);
パラメーター
qdw
種類: LONGLONG
変換する数値。
[out] pszBuf
種類: PSTR
この関数が正常に返されると、変換された数値を受け取るバッファーへのポインター。
cchBuf
型: UINT
pszBuf が指すバッファーのサイズ (文字単位)。
戻り値
種類: PSTR
変換された文字列へのポインターを返します。変換が失敗した場合は NULL を 返します。
解説
StrFormatByteSize64 は、ANSI 文字または Unicode 文字に使用できます。 ただし、 StrFormatByteSize64A は直接呼び出すことができますが、 StrFormatByteSize64W は定義されていません。 StrFormatByteSize64 が Unicode 値で呼び出されると、StrFormatByteSizeW が使用されます。
Windows 10では、サイズはベース 2 ではなくベース 10 で報告されます。 たとえば、1 KB は 1024 ではなく 1000 バイトです。
次の表は、この関数が数値をテキスト文字列に変換する方法を示しています。
| 数値 | テキスト文字列 |
|---|---|
| 532 | 532 バイト |
| 1340 | 1.30 KB |
| 23506 | 23.5 KB |
| 2400016 | 2.40 MB |
| 2400000000 | 2.4 GB |
要件
| サポートされている最小のクライアント | Windows 2000 Professional、Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | shlwapi.h |
| Library | Shlwapi.lib |
| [DLL] | Shlwapi.dll (バージョン 5.0 以降) |