IVdsVolumeMF：：AddAccessPath 方法 (vds.h)

[從Windows 8和Windows Server 2012開始，虛擬磁碟服務COM 介面會由Windows 儲存體管理 API取代。

加入存取路徑。

語法

HRESULT AddAccessPath(
  [in] LPWSTR pwszPath
);

[in] pwszPath

字串，指出存取路徑，這是可用來開啟磁片區的使用者模式路徑。存取路徑可以是磁碟機號或 NTFS 磁片區上空目錄的路徑。存取路徑字串必須包含尾端反斜線，例如「F：」。

這個方法可以傳回標準 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及 VDS 特定的傳回值。它也可以使用HRESULT_FROM_WIN32宏傳回已轉換的系統錯誤碼。錯誤可能源自 VDS 本身，或來自正在使用的基礎 VDS 提供者。可能的傳回值包括下列專案。

傳回碼/值	描述
S_OK	已成功新增路徑。
S_FALSE	不過，已成功新增存取路徑，但發生錯誤。 VDS 可能無法更新分割區的GPT_BASIC_DATA_ATTRIBUTE_NO_DRIVE_LETTER屬性，或無法在新增磁碟機號時新增預設網路共用 (例如 F$) 。如需詳細資訊，請參閱 PARTITION_INFORMATION_GPT。
VDS_E_OBJECT_STATUS_FAILED 0x80042431L	磁片區失敗。
VDS_E_PACK_OFFLINE 0x80042444L	無法存取包含磁片區的套件。

VDS 會藉由建立掛接的資料夾來新增存取路徑， (也稱為磁片區掛接點) 。請注意，掛接的資料夾僅支援 NTFS 磁片區。如需詳細資訊，請參閱掛接的資料夾。

即使目錄是空的) ，或pwszPath 包含空目錄的路徑，pwszPath參數還是包含空目錄的路徑，這個方法會傳 ERROR_DIR_NOT_EMPTY回 (。