FindNextVolumeW 関数 (fileapi.h)

  • [アーティクル]

FindFirstVolume 関数の呼び出しによって開始されたボリューム検索を続けます。 FindNextVolume は、呼び出しごとに 1 つのボリュームを検索します。

構文

BOOL FindNextVolumeW(
  [in]  HANDLE hFindVolume,
  [out] LPWSTR lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

パラメーター

[in] hFindVolume

FindFirstVolume 関数の以前の呼び出しによって返されるボリューム検索ハンドル。

[out] lpszVolumeName

見つかったボリューム GUID パスを受け取る文字列へのポインター。

[in] cchBufferLength

ボリューム GUID パスを受け取るバッファーの長さ (TCHAR)。

戻り値

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

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 一致するファイルが見つからない場合、 GetLastError 関数は ERROR_NO_MORE_FILES エラー コードを返します。 その場合は、 FindVolumeClose 関数を使用して検索を閉じます。

解説

FindFirstVolume を呼び出して検索ハンドルを確立したら、FindNextVolume 関数を使用して他のボリュームを検索できます。

これらの関数によって返されるボリュームの順序と、コンピューター上のボリュームの順序との間に相関関係は想定しないでください。 特に、BIOS (存在する場合) またはディスクの管理で割り当てられたボリュームの順序とドライブ文字の間に相関関係があるとは想定しないでください。

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

テクノロジ サポートされています
サーバー メッセージ ブロック (SMB) 3.0 プロトコル いいえ
SMB 3.0 Transparent Failover (TFO) いいえ
スケールアウト ファイル共有 (SO) を使う SMB 3.0 いいえ
クラスターの共有ボリューム ファイル システム (CsvFS) はい
Resilient File System (ReFS) はい
 

SMB では、ボリューム管理機能はサポートされていません。

例

例については、「 ボリューム パスの表示」を参照してください。

要件

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

関連項目

FindFirstVolume

FindVolumeClose

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

ボリューム管理の関数