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 オブジェクト。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード/値 | 説明 |
---|---|
|
操作に成功しました。 |
|
outRestartTask パラメーターは NULL です。 |
|
予期しないエラーが発生しました。 |
|
操作がタイムリーに完了しませんでした。 |
|
この操作には、仮想マシン (VM) が実行されている必要があります。 |
|
構成が不明です。 |
|
統合コンポーネント機能は、この 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 |
ヘッダー |
|
IID |
IID_IVMGuestOSは 99fea0db-4880-499a-b6d8-73dff9bc91be として定義されています |