共用方式為

IVMGuestOS：：Restart 方法

  • 發行項

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

重新開機客體作業系統。

語法

HRESULT Restart(
  [in]          VARIANT_BOOL inForced,
  [out, retval] IVMTask      **outRestartTask
);

參數

inForced [in]

VARIANT_TRUE 如果需要強制重新開機，否則 VARIANT_FALSE 。

outRestartTask [out， retval]

用來追蹤重新開機順序完成進度的 IVMTask 物件。

傳回值

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

傳回碼/值 描述
S_OK
0
 作業成功。
E_POINTER
0x80004003
 outRestartTask參數為Null。
DISP_E_EXCEPTION
0x80020009
 已發生未預期的錯誤。
VM_E_TIMED_OUT
0xA0040202
 作業未及時完成。
VM_E_VM_NOT_RUNNING
0xA0040206
 虛擬機器 (VM) 必須針對此作業執行。
VM_E_VM_UNKNOWN
0xA0040207
 組態未知。
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 此 VM 中未安裝整合元件功能。

備註

下列值可以透過傳回之 IVMTask物件的Error屬性傳回。

錯誤 碼/值 Description
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) (0x80070005)
呼叫端必須具有此 VM 的執行存取權限。
HRESULT_FROM_WIN32(ERROR_MACHINE_LOCKED) (0x800704f7)
電腦已鎖定，而且無法在沒有強制選項的情況下關閉。
HRESULT_FROM_WIN32(ERROR_NOT_READY) (0x80070015)
裝置未就緒。
HRESULT_FROM_WIN32(ERROR_SHUTDOWN_IN_PROGRESS) (0x8007045b)
系統關機正在進行中。

規格需求

需求 值
最低支援的用戶端
 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器
 都不支援
用戶端支援結束
 Windows 7
產品
 Windows Virtual PC
標頭
HTTPCOMInterfaces.h
IID
 IID_IVMGuestOS定義為 99fea0db-4880-499a-b6d8-73dff9bc91be

另請參閱

IVMGuestOS