Share via

IVMVirtualMachine：：AddHardDiskConnection 方法

  • 發行項

[Windows 虛擬電腦已不再可供Windows 8使用。 請改用 Hyper-V WMI 提供者 (V2) 。]

將新的硬碟連線新增至虛擬機器 (VM) 。

語法

HRESULT AddHardDiskConnection(
  [in]          BSTR                  hardDiskPath,
  [in]          long                  busNumber,
  [in]          long                  deviceNumber,
  [out, retval] IVMHardDiskConnection **hardDiskConnection
);

參數

hardDiskPath [in]

要連線的虛擬硬碟 (VHD) 檔案的完整路徑。

busNumber [in]

將連接磁片磁碟機的匯流排。

值 意義
0
 磁片磁碟機會連結至第一個匯流排。
1
 磁片磁碟機會附加至第二個匯流排。

deviceNumber [in]

要連結磁片磁碟機的裝置。

值 意義
0
 磁片磁碟機將會連結至匯流排上的第一個裝置。
1
 磁片磁碟機將會連結至匯流排上的第二個裝置。

hardDiskConnection [out， retval]

IVMHardDiskConnection物件。

傳回值

這個方法可以傳回其中一個值。

傳回碼/值 描述
S_OK
0
 作業成功。
E_POINTER
0x80004003
 hardDiskConnection參數為Null。
E_INVALIDARG
0x80000003
 hardDiskPath參數為Null或busNumber 或 deviceNumber參數無效。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 系統找不到 hardDiskPath 參數指定的檔案。
HRESULT_FROM_WIN32 (ERROR_PATH_NOT_FOUND)
0x80070003
 系統找不到 hardDiskPath 參數所指定的路徑。
HRESULT_FROM_WIN32 (ERROR_INVALID_NAME)
0x8007007b
 hardDiskPath參數包含無效字元 (「*？ <>/|「：」) 。
HRESULT_FROM_WIN32 (ERROR_BAD_PATHNAME)
0x800700a1
 hardDiskPath參數會指定空路徑或相對路徑。 絕對路徑是必要的。
HRESULT_FROM_WIN32 (ERROR_BUFFER_OVERFLOW)
0x8007006f
 hardDiskPath參數指定的路徑太長。 路徑必須小於 260 個字元。
VM_E_VM_UNKNOWN
0xA0040207
 組態未知。
VM_E_VM_RUNNING_OR_SAVED
0xA004020B
 VM 處於執行中或已儲存的狀態。
VM_E_DRIVE_BUS_LOC_IN_USE
0xA00400503
 指定的匯流排位置正在使用中。
VM_E_INVALID_HD_FILE
0xA0040682
 VHD 大於 127 GB，且無法連線到 IDE 匯流排。
VM_E_UNSUPPORTED_HD_DISK_TYPE
0xA00400686
 hardDiskPath參數是指連結的 VHD 或差異 VHD 與連結的 VHD。 連結的 VHD 無法連結至虛擬機器。
HRESULT_FROM_WIN32 (ERROR_SHARING_VIOLATION)
0x80070020
 指定的 VHD 已經連線到此 VM 的另一個匯流排位置。
DISP_E_EXCEPTION
0x80020009
 已發生未預期的錯誤。

備註

您只能將新的硬碟連線新增至已停止的虛擬機器。

規格需求

需求 值
最低支援的用戶端
 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器
 都不支援
用戶端支援結束
 Windows 7
產品
 Windows Virtual PC
標頭
HTTPCOMInterfaces.h
IID
 IID_IVMVirtualMachine定義為 f7092aa1-33ed-4f78-a59f-c00adfc2edd7

另請參閱

IVMVirtualMachine