MSFT_Partition 類別的 AddAccessPath 方法
將掛接路徑或驅動器號指派新增至分割區。
語法
UInt32 AddAccessPath(
[in] String AccessPath,
[in] Boolean AssignDriveLetter,
[out] String ExtendedStatus
);
參數
AccessPath [in]
指定存取路徑，這是可用來開啟數據分割的使用者模式路徑。 存取路徑可以是磁碟機代號 (例如 "C:" 或 "C:\") 或 NTFS 磁碟區上空目錄的路徑。 存取路徑字串的結尾不需要反斜線。
AssignDriveLetter [in]
如果 為 TRUE，則會將下一個可用的驅動器號指派給分割區。
ExtendedStatus [out]
包含內嵌 MSFT_StorageExtendedStatus 物件的字串。
此參數可讓記憶體提供者傳回擴充 (實作特定) 錯誤資訊。
傳回值
成功 (0)
不支援 (1)
未指定的錯誤 (2)
逾 時 (3)
失敗 (4)
無效的參數 (5)
拒絕存取 (40001)
沒有足夠的資源來完成作業。 (40002)
要求的存取路徑已在使用中。 (42002)
無法將存取路徑指派給隱藏的數據分割。 (42004)
存取路徑無效。 (42007)
備註
這個方法會將掛接路徑或驅動器號指派新增至分割區。 AccessPath 和 AssignDriveLetter 參數互斥，如果同時指定兩個參數，將會產生無效的參數錯誤。 此方法會藉由建立掛接的資料夾 (也稱為磁碟區裝入點) 來新增存取路徑。 請注意，掛接的資料夾僅支援NTFS格式化的數據分割。 如果 AccessPath 中指定的路徑是已在使用中的資料夾，即使目錄是空的 () ，或包含非空白目錄的路徑，這個方法仍會傳回錯誤。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 命名空間 | Root\Microsoft\Windows\Storage |
| 標頭 | Vds.h |
| MOF | Storagewmi.mof |