IVMGuestOS::Restart メソッド

  • [アーティクル]

[Windows Virtual PC は、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 プロパティを使用して、次の値を返すことができます。

エラー コード/値 説明
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
Product
 Windows Virtual PC
ヘッダー
VPCCOMInterfaces.h
IID
 IID_IVMGuestOSは 99fea0db-4880-499a-b6d8-73dff9bc91be として定義されています

関連項目

IVMGuestOS