共用方式為


setVolumeMountPointA 函式 (winbase.h)

將磁片區與磁碟機號或另一個磁片區上的目錄產生關聯。

語法

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

參數

[in] lpszVolumeMountPoint

要與磁片區相關聯的使用者模式路徑。 這可能是 (磁碟機號,例如「X:\」) 或另一個磁片區上的目錄 (,例如 「Y:\MountX」) 。 字串的結尾必須是尾端反斜線 ('') 。

[in] lpszVolumeName

磁片區的磁片區 GUID 路徑。 此字串的格式必須是 「\\?\Volume{GUID}」,其中 GUID 是識別磁片區的 GUID 。 「\\?」 會關閉路徑剖析,並忽略為路徑的一部分,如 命名磁片區中所述。

傳回值

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 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 標頭會將 SetVolumeMountPoint 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程式碼,可能會導致編譯或執行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 winbase.h (包含 Windows.h)
程式庫 Kernel32.lib
DLL Kernel32.dll

另請參閱

DeleteVolumeMountPoint

GetVolumeNameForVolumeMountPoint

GetVolumePathName

掛接的資料夾

磁片區管理功能