FindFirstVolumeW

コンピュータ上のボリュームの名前を取得する。(FindFirstVolumeW)

FindFirstVolumeW lpszVolumeName, cchBufferLength

lpszVolumeName : [wstr] 見つかった最初のボリュームのボリューム GUID パスを指定する NULL 終端文字列を受け取るバッファへのポインタ。
cchBufferLength : [int] ボリューム GUID パスを受け取るバッファの長さ（TCHAR 単位）。

(プラグイン / モジュール : kernel32.dll)

解説

コンピュータ上のボリュームの名前を取得する。(FindFirstVolumeW)

[戻り値]
関数が成功した場合、戻り値は FindNextVolume および FindVolumeClose
関数の以降の呼び出しで使用される検索ハンドルである。ボリュームが見つからない場合、戻り値は INVALID_HANDLE_VALUE
エラーコードとなる。拡張エラー情報を取得するには GetLastError を呼ぶ。

[備考]
FindFirstVolume
関数は、ボリューム検索ハンドルを開き、コンピュータ上で見つかった最初のボリュームに関する情報を返す。検索ハンドルが確立されたら、FindNextVolume
関数を使って他のボリュームを検索できる。検索ハンドルが不要になったら、FindVolumeClose
関数を使って閉じる。これらの関数が返すボリュームの順序とコンピュータ上のボリュームの順序との間に相関があると想定してはならない。特に、ボリューム順序と
BIOS（存在する場合）または Disk Administrator
によって割り当てられたドライブ文字との間に相関があると想定してはならない。Windows 8 および Windows Server
2012 では、この関数は次の技術でサポートされる。
（以下省略）

情報