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 として定義されています

関連項目

IVMGuestOS