FindFirstVolumeMountPointW 関数 (winbase.h)

指定したボリューム上のマウントされたフォルダーの名前を取得します。 FindFirstVolumeMountPoint は、ボリューム上のマウントされたフォルダーのスキャンを開始するために使用されます。

構文

HANDLE FindFirstVolumeMountPointW(
  [in]  LPCWSTR lpszRootPathName,
  [out] LPWSTR  lpszVolumeMountPoint,
  [in]  DWORD   cchBufferLength
);

パラメーター

[in] lpszRootPathName

マウントされたフォルダーをスキャンするボリュームのボリューム GUID パス。 末尾の円記号が必要です。

[out] lpszVolumeMountPoint

見つかった最初のマウントされたフォルダーの名前を受け取るバッファーへのポインター。

[in] cchBufferLength

マウントされたフォルダーへのパスを受け取るバッファーの長さ (TCHAR単位)。

戻り値

関数が成功した場合、戻り値は FindNextVolumeMountPoint 関数と FindVolumeMountPointClose 関数の後続の呼び出しで使用される検索ハンドル です 。

関数がボリューム上のマウントされたフォルダーを見つけられない場合、戻り値は INVALID_HANDLE_VALUE エラー コードです。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

FindFirstVolumeMountPoint 関数は、マウントされたフォルダー検索ハンドルを開き、指定したボリュームで最初にマウントされたフォルダーに関する情報を返します。 検索ハンドルが確立されたら、 FindNextVolumeMountPoint 関数を使用して、マウントされている他のフォルダーを検索できます。 検索ハンドルが不要になったら、 FindVolumeMountPointClose 関数で閉じます。

FindFirstVolumeMountPoint、FindNextVolumeMountPoint、および FindVolumeMountPointClose 関数は、指定されたボリュームのマウントされたフォルダーへのパスを返します。 ドライブ文字やボリューム GUID パスは返されません。 ボリュームのボリューム GUID パスの列挙については、「ボリューム GUID パスの列挙」を参照してください。

これらの関数によって返されるマウントされたフォルダーの順序と、他の関数またはツールによって返されるマウントされたフォルダーの順序との間に、相関関係を想定しないでください。

Windows 8 と Windows Server 2012 では、この関数は、次のテクノロジによってサポートされています。

SMB では、ボリューム管理機能はサポートされていません。 CsvFS では、CSV ボリュームへのマウント ポイントの追加はサポートされていません。 ReFS はマウント ポイントのインデックスを作成しません。

要件

関連項目

FindNextVolumeMountPoint

FindVolumeMountPointClose

マウントされたフォルダー

ボリューム管理の関数