GetVolumePathNamesForVolumeNameW 関数 (fileapi.h)

  • [アーティクル]

指定したボリュームのドライブ文字とマウントされたフォルダー パスの一覧を取得します。

構文

BOOL GetVolumePathNamesForVolumeNameW(
  [in]  LPCWSTR lpszVolumeName,
  [out] LPWCH   lpszVolumePathNames,
  [in]  DWORD   cchBufferLength,
  [out] PDWORD  lpcchReturnLength
);

パラメーター

[in] lpszVolumeName

ボリュームのボリューム GUID パス。 ボリューム GUID パスは"\\?\Volume{xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxx}\" という形式です。

[out] lpszVolumePathNames

ドライブ文字とマウントされたフォルダー パスの一覧を受け取るバッファーへのポインター。 リストは、追加の NULL 文字で終わる null で終わる文字列の配列です。 バッファーが完全なリストを保持するのに十分な大きさでない場合、バッファーは可能な限り多くのリストを保持します。

[in] cchBufferLength

すべての NULL 文字を含む TCHAR のlpszVolumePathNames バッファーの長さ。

[out] lpcchReturnLength

呼び出しが成功した場合、このパラメーターは lpszVolumePathNames バッファーにコピーされた TCHAR の数です。 それ以外の場合、このパラメーターは、完全なリストを TCHAR に保持するために必要なバッファーのサイズです。

戻り値

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

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。 バッファーが完全な一覧を保持するのに十分な大きさでない場合、エラー コードは ERROR_MORE_DATA され、 lpcchReturnLength パラメーターは必要なバッファー サイズを受け取ります。

注釈

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

関連項目

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

ボリューム管理の関数