FindFirstVolumeMountPointA 関数 (winbase.h)

  • [アーティクル]

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

構文

HANDLE FindFirstVolumeMountPointA(
  [in]  LPCSTR lpszRootPathName,
  [out] LPSTR  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) 3.0 プロトコル いいえ
SMB 3.0 Transparent Failover (TFO) いいえ
スケールアウト ファイル共有 (SO) を使う SMB 3.0 いいえ
クラスターの共有ボリューム ファイル システム (CsvFS) いいえ
Resilient File System (ReFS) いいえ
 

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

Note

winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして FindFirstVolumeMountPoint を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー winbase.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

FindNextVolumeMountPoint

FindVolumeMountPointClose

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

ボリューム管理の関数