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 では、ボリューム管理機能はサポートされていません。

例

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

要件

関連項目

FindFirstVolume

FindVolumeClose

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

ボリューム管理の関数