SetVolumeMountPointA 関数 (winbase.h)

ボリュームをドライブ文字または別のボリューム上のディレクトリに関連付けます。

構文

BOOL SetVolumeMountPointA(
  [in] LPCSTR lpszVolumeMountPoint,
  [in] LPCSTR lpszVolumeName
);

パラメーター

[in] lpszVolumeMountPoint

ボリュームに関連付けるユーザー モード パス。 ドライブ文字 ("X:\"など) または別のボリューム上のディレクトリ ("Y:\MountX\" など) を指定できます。 文字列は末尾の円記号 ('\') で終わる必要があります。

[in] lpszVolumeName

ボリューム ボリュームの GUID パス。 この文字列は、"\\?\Volume{GUID}\" の形式である必要があります。GUID は、ボリュームを識別する GUID です。 "\\?\" はパスの解析をオフにし、「ボリュームの名前付け で説明されているように、パスの一部として無視されます。

戻り値

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

関数が失敗した場合、戻り値は 0 です。 拡張エラー情報を取得するには、GetLastError呼び出します。

lpszVolumeMountPoint パラメーターにマウントされたフォルダーへのパスが含まれている場合、GetLastError は、ディレクトリが空であっても、ERROR_DIR_NOT_EMPTYを返します。

備考

この関数を使用してボリュームを別のボリューム上のディレクトリに関連付ける場合、関連付けられたディレクトリはマウントされた フォルダーと呼ばれます。

ファイルまたはサブディレクトリがあるディレクトリにボリュームを関連付けるのはエラーです。 このエラーは、システムおよび非表示のディレクトリ、およびその他のディレクトリで発生し、システムファイルと隠しファイルに対して発生します。

マウントされたフォルダーがクラスター化されたディスク上のボリュームに作成されると、特定の状況で予期せず削除される可能性があります。 マウントされたフォルダーを作成して構成してこれが発生しないようにする方法については、「クラスター ディスクとドライブの接続の問題 を参照してください。

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

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

 

SMB はボリューム管理機能をサポートしていません。 CsvFS の場合、新しいマウント ポイントはクラスター上の他のノードにはレプリケートされません。

例

例については、「マウントフォルダーの作成」を参照してください。

手記

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

必要条件

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

関連項目

DeleteVolumeMountPoint の

GetVolumeNameForVolumeMountPoint の

GetVolumePathName を する

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

ボリューム管理機能 の