IVMGuestOS::Shutdown メソッド

[Windows Virtual PC は、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
Header	VPCCOMInterfaces.h
IID	IID_IVMGuestOSは 99fea0db-4880-499a-b6d8-73dff9bc91be として定義されています