FindFirstVolumeMountPointW

指定されたボリューム上のマウントフォルダの名前を取得する。(Unicode)

FindFirstVolumeMountPointW lpszRootPathName, lpszVolumeMountPoint, cchBufferLength

lpszRootPathName : [wstr] マウントフォルダをスキャンするボリュームのボリューム GUID パス。末尾のバックスラッシュが必要。
lpszVolumeMountPoint : [wstr] 見つかった最初のマウントフォルダの名前を受け取るバッファへのポインタ。
cchBufferLength : [int] マウントフォルダへのパスを受け取るバッファの長さ（TCHAR 単位）。

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

解説

指定されたボリューム上のマウントフォルダの名前を取得する。(Unicode)

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

[備考]
FindFirstVolumeMountPoint
関数は、マウントフォルダ検索ハンドルを開き、指定されたボリューム上で見つかった最初のマウントフォルダに関する情報を返す。検索ハンドルが確立されたら、FindNextVolumeMountPoint
関数を使って他のマウントフォルダを検索できる。検索ハンドルが不要になったら、FindVolumeMountPointClose
関数を使って閉じる。FindFirstVolumeMountPoint、FindNextVolumeMountPoint、FindVolumeMountPointClose
関数は、指定されたボリュームのマウントフォルダへのパスを返す。これらはドライブ文字やボリューム GUID
パスを返さない。ボリュームのボリューム GUID パスを列挙する方法については Enumerating Volume GUID Paths
を参照。これらの関数が返すマウントフォルダの順序と、他の関数やツールが返すマウントフォルダの順序との間に相関があると想定してはならない。Windows
8 および Windows Server 2012 では、この関数は次の技術でサポートされる。
（以下省略）

情報