FindNextVolumeMountPointA 関数 (winbase.h)

FindFirstVolumeMountPoint 関数の呼び出しによって開始された、マウントされたフォルダーの検索を続けます。 FindNextVolumeMountPoint は、呼び出しごとに 1 つのマウントされたフォルダーを検索します。

構文

BOOL FindNextVolumeMountPointA(
  [in]  HANDLE hFindVolumeMountPoint,
  [out] LPSTR  lpszVolumeMountPoint,
  [in]  DWORD  cchBufferLength
);

パラメーター

[in] hFindVolumeMountPoint

FindFirstVolumeMountPoint 関数の以前の呼び出しによって返されるマウントされたフォルダー検索ハンドル。

[out] lpszVolumeMountPoint

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

[in] cchBufferLength

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

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 マウントされたフォルダーが見つからない場合、 GetLastError 関数は ERROR_NO_MORE_FILES エラー コードを返します。 その場合は、 FindVolumeMountPointClose 関数を使用して検索を閉じます。

注釈

FindFirstVolumeMountPoint を呼び出して検索ハンドルが確立されたら、FindNextVolumeMountPoint 関数を使用して、他のマウントされたフォルダーを検索できます。

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 はマウント ポイントのインデックスを作成しません。

注意

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

要件

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

関連項目

FindFirstVolumeMountPoint

FindVolumeMountPointClose

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

ボリューム管理の関数