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 物件。
傳回值
這個方法可以傳回下列其中一個值。
| 傳回碼/值 | 描述 |
|---|---|
|
作業成功。 |
|
outShutdownTask參數為Null。 |
|
作業未及時完成。 |
|
找不到 VM。 |
|
VM 必須針對此作業執行。 |
|
呼叫端必須具有此 VM 的執行存取權限。 |
|
此 VM 中未安裝整合元件功能。 |
|
已發生未預期的錯誤。 |
備註
叫用此方法時，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 |
| 標頭 |
|
| IID |
IID_IVMGuestOS定義為 99fea0db-4880-499a-b6d8-73dff9bc91be |