FindFirstVolume

Declare Function Api_FindFirstVolume& Lib "kernel32" Alias "FindFirstVolumeA" (ByVal lpszVolumeName$, ByVal cchBufferLength&)

Declare Function FindFirstVolume Lib "kernel32" Alias "FindFirstVolumeA" (ByVal lpszVolumeName As String, ByVal cchBufferLength As Long) As Long

コンピュータ上のボリューム名を返す。ボリュームのスキャンを開始するために使われる。

パラメータ
lpszVolumeName
    最初に検出されたボリュームの、一意のボリューム名を受け取る文字列へのポインタを指定する。
cchBufferLength
    ボリューム名を受け取るバッファの長さを文字数で指定する。

戻り値
    関数が成功すると検索ハンドルが返り、FindNextVolume 関数や FindVolumeClose 関数への呼び出しで使える。
    関数がボリュームの検出に失敗した場合、INVALID_HANDLE_VALUE エラーコードが返る。拡張エラー情報を取得するには、

    GetLastError 関数を使う。

解説
    FindFirstVolume 関数はボリューム検索ハンドルを開き、コンピュータ上で最初に検出されたボリュームに関する情報を返す。検索ハンドル

    が確立されると、FindNextVolume 関数を使ってほかのボリュームを検索できる。検索ハンドルが不要になった場合は、FindVolumeClose

    関数を使ってそのハンドルを閉じる。
    関数によって返されるボリューム順とコンピュータ上のボリューム順に関連はない。特に、返されたボリューム順と、Disk Administrator や

    BIOS で割り当てられたドライブ名には、何の関係もない。