FindFirstVolumeW 関数 (fileapi.h)

  • [アーティクル]

コンピューター上のボリュームの名前を取得します。 FindFirstVolume は、コンピューターのボリュームのスキャンを開始するために使用されます。

構文

HANDLE FindFirstVolumeW(
  [out] LPWSTR lpszVolumeName,
  [in]  DWORD  cchBufferLength
);

パラメーター

[out] lpszVolumeName

見つかった最初のボリュームのボリューム GUID パスを指定する null で終わる文字列を受け取るバッファーへのポインター。

[in] cchBufferLength

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

戻り値

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

関数がボリュームの検索に失敗した場合、戻り値は INVALID_HANDLE_VALUE エラー コードです。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

FindFirstVolume 関数は、ボリューム検索ハンドルを開き、コンピューターで見つかった最初のボリュームに関する情報を返します。 検索ハンドルが確立されたら、 FindNextVolume 関数を使用して他のボリュームを検索できます。 検索ハンドルが不要になったら、 FindVolumeClose 関数を使用して閉じます。

これらの関数によって返されるボリュームの順序と、コンピューター上のボリュームの順序との間に相関関係は想定しないでください。 特に、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

関連項目

FindNextVolume

FindVolumeClose

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

ボリューム管理の関数