IVMGuestOS：：Shutdown 方法

  • 發行項

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

關閉虛擬機器中的客體作業系統， (VM) 。

語法

HRESULT Shutdown(
  [in]          VARIANT_BOOL isForced,
  [out, retval] IVMTask      **outShutdownTask
);

參數

isForced [in]

VARIANT_TRUE 如果要強制關機， VARIANT_FALSE 否則為 。

outShutdownTask [out， retval]

用來追蹤關機程式完成的 IVMTask 物件。

傳回值

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

傳回碼/值 描述
S_OK
0
 作業成功。
E_POINTER
0x80004003
 outShutdownTask參數為Null。
VM_E_TIMED_OUT
0xA0040202
 作業未及時完成。
VM_E_VM_UNKNOWN
0xA0040207
 找不到 VM。
VM_E_VM_NOT_RUNNING
0xA0040206
 VM 必須針對此作業執行。
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)
0x80070005
 呼叫端必須具有此 VM 的執行存取權限。
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 此 VM 中未安裝整合元件功能。
DISP_E_EXCEPTION
0x80020009
 已發生未預期的錯誤。

備註

叫用此方法時，VM 必須執行，而且必須安裝整合元件功能。 只有以 Windows 為基礎的客體作業系統才支援這個方法。

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

錯誤 碼/值 描述
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
標頭
VPCOMInterfaces.h
IID
 IID_IVMGuestOS定義為 99fea0db-4880-499a-b6d8-73dff9bc91be

另請參閱

IVMGuestOS