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 中指定的路徑是已在使用中的資料夾，即使目錄是空的 () ，或包含非空白目錄的路徑，這個方法仍會傳回錯誤。

規格需求

另請參閱

MSFT_Partition