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-xxxxxxxxxxxx}\" の形式です。

[out] lpszVolumePathNames

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

[in] cchBufferLength

lpszVolumePathNames バッファーの長さ (WCHAR内) (すべての null 文字 含む)。

[out] lpcchReturnLength

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

戻り値

関数が成功した場合、戻り値は 0 以外です。

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

備考

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

テクノロジー	サポート
サーバー メッセージ ブロック (SMB) 3.0 プロトコル	いいえ
SMB 3.0 透過的フェールオーバー (TFO)	いいえ
SMB 3.0 とスケールアウト ファイル共有 (SO)	いいえ
クラスター共有ボリューム ファイル システム (CsvFS)	はい
回復性のあるファイル システム (ReFS)	はい

 

SMB はボリューム管理機能をサポートしていません。

例

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

必要条件

要件	価値
サポートされる最小クライアント	Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー	Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	fileapi.h (Windows.h を含む)
ライブラリ	Kernel32.lib
DLL	Kernel32.dll

関連項目

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

ボリューム管理機能 の