IVMVirtualPC：：RegisterVirtualMachine 方法

  • 發行項

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

註冊現有的虛擬機器組態，並擷取虛擬機器物件。

語法

HRESULT RegisterVirtualMachine(
  [in]          BSTR              configurationName,
  [in]          BSTR              configurationPath,
  [out, retval] IVMVirtualMachine **virtualMachine
);

參數

configurationName [in]

要註冊的虛擬機器名稱。 名稱的長度不能超過 80 個字元，名稱與路徑的合併長度不能超過 MAX_PATH ( 260) 個字元。 指定的名稱可能包含 .vmc 副檔名。 如果此參數為 Null 或空字串， configurationPath 參數必須指定組態檔的完整路徑。

configurationPath [in]

包含現有組態檔的資料夾路徑。 如果 configurationName 參數為 Null 或空字串，則必須指定現有組態檔的完整路徑。

virtualMachine [out， retval]

代表此虛擬機器之新 IVMVirtualMachine 物件的指標。

傳回值

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

傳回碼/值 描述
S_OK
0
 作業成功。
E_POINTER
0x80004003
 configurationName或configurationPath參數無效，或virtualMachine為Null。
HRESULT_FROM_WIN32 (ERROR_PATH_NOT_FOUND)
0x80070003
 系統找不到 configurationName 和 configurationPath 參數所指定的路徑。
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 系統找不到 configurationName 和 configurationPath 參數指定的檔案。
HRESULT_FROM_WIN32 (ERROR_INVALID_NAME)
0x8007007b
 configurationPath參數包含不正確字元 (「*？： <> /|」) 。
HRESULT_FROM_WIN32 (ERROR_BAD_PATHNAME)
0x800700a1
 參數 configurationPath 參數會指定空路徑或相對路徑。 絕對路徑是必要的。
HRESULT_FROM_WIN32 (ERROR_BUFFER_OVERFLOW)
0x8007006f
 configurationName和configurationPath參數所指定的路徑會導致路徑太長。 路徑的組合長度必須小於 MAX_PATH ( 260) 個字元。
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)
0x800700b7
 此位置已有具有此名稱的組態檔。
VM_E_CONFIG_NAME_TOO_LONG
0xA0040401
 configurationName參數長度超過 80 個字元。
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 configurationName參數包含不正確字元， (「*？： <> /|\」「) 之一。
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 已經有具有此名稱的虛擬機器。
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 處理器不支援硬體加速虛擬化 (HAV) 擴充功能。
DISP_E_EXCEPTION
0x80020009
 已發生未預期的錯誤。

備註

虛擬機器名稱不區分大小寫，例如「MyVM」 和 「myvm」 是指相同的虛擬機器。

規格需求

需求 值
最低支援的用戶端
 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器
 都不支援
用戶端支援結束
 Windows 7
產品
 Windows Virtual PC
標頭
HTTPCOMInterfaces.h
IID
 IID_IVMVirtualPC定義為 236ba0d9-a24a-4292-a132-27c1421dfd01

另請參閱

IVMVirtualPC