次の方法で共有


FindFirstVolumeMountPointA 関数 (winbase.h)

指定したボリュームにマウントされているフォルダーの名前を取得します。 FindFirstVolumeMountPoint は、ボリューム上のマウントされたフォルダーのスキャンを開始するために使用されます。

構文

HANDLE FindFirstVolumeMountPointA(
  [in]  LPCSTR lpszRootPathName,
  [out] LPSTR  lpszVolumeMountPoint,
  [in]  DWORD  cchBufferLength
);

パラメーター

[in] lpszRootPathName

マウントされたフォルダーをスキャンするボリュームのボリューム GUID パス。 末尾の円記号が必要です。

[out] lpszVolumeMountPoint

最初に見つかったマウントされたフォルダーの名前を受け取るバッファーへのポインター。

[in] cchBufferLength

マウントされたフォルダーへのパスを受け取るバッファーの長さ (TCHAR単位)。

戻り値

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

関数がボリュームにマウントされているフォルダーを見つけ出さなければ、戻り値は INVALID_HANDLE_VALUE エラー コードになります。 拡張エラー情報を取得するには、GetLastError呼び出します。

備考

FindFirstVolumeMountPoint 関数は、マウントされたフォルダー検索ハンドルを開き、指定されたボリュームで最初にマウントされたフォルダーに関する情報を返します。 検索ハンドルが確立されたら、FindNextVolumeMountPoint 関数を使用して、マウントされた他のフォルダーを検索できます。 検索ハンドルが不要になったら、FindVolumeMountPointClose 関数で閉じます。

FindFirstVolumeMountPointFindNextVolumeMountPoint、および FindVolumeMountPointClose 関数は、指定されたボリュームのマウントされたフォルダーへのパスを返します。 GUID パス ドライブ文字やボリュームは返されません。 ボリュームのボリューム GUID パスの列挙については、「ボリューム GUID パスの列挙」を参照してください。

これらの関数によって返されるマウントされたフォルダーの順序と、他の関数またはツールによって返されるマウントされたフォルダーの順序との間に相関関係があるとは想定しないでください。

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

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

SMB はボリューム管理機能をサポートしていません。 CsvFS では、CSV ボリュームへのマウント ポイントの追加はサポートされていません。 ReFS はマウント ポイントのインデックスを作成しません。

手記

winbase.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして FindFirstVolumeMountPoint を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

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

関連項目

FindNextVolumeMountPoint の

FindVolumeMountPointClose

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

ボリューム管理機能 の