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