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

例

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

要件

関連項目

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

ボリューム管理の関数