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 不支援磁碟區管理功能。對於 CsvFS，新的裝入點將不會復寫到叢集上的其他節點。

如需範例，請參閱建立掛接的資料夾。

注意

winbase.h 標頭會根據 UNICODE 預處理器常數的定義，將 SetVolumeMountPoint 定義為自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。