IVMVirtualMachine::Startup2 メソッド

[Windows Virtual PC は、Windows 8の時点で使用できなくなります。代わりに、 Hyper-V WMI プロバイダー (V2)を使用します。

高度なオプションを使用して、初期化されていない状態または保存された状態から仮想マシン (VM) を起動します。

このメソッドは、親ディスクのタイムスタンプが変更された場合でも、差分ディスクで VM を起動するメカニズムを提供します。

構文

HRESULT Startup2(
  [in]          VMStartupOption startupOption,
  [out, retval] IVMTask         **startupTask
);

startupOption [in]: 高度なスタートアップオプション。指定できる値は、 VMStartupOption 列挙からの値です。
startupTask [out, retval]: 開始シーケンスの完了の進行状況を追跡するために使用される IVMTask オブジェクト。

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード/値	説明
S_OK 0	操作に成功しました。
E_INVALIDARG 0x80000003	startupOption パラメーターが無効です。
E_POINTER 0x80004003	startupTask パラメーターが NULL です。
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) 0x80070005	この VM を起動するには、呼び出し元に実行アクセス許可が必要です。
VM_E_TIMED_OUT 0xA0040202	操作がタイムリーに完了しませんでした。
VM_E_OUT_OF_RESOURCE 0xA0040203	十分なホストリソースがありません。
VM_E_TOO_MANY_VMS 0xA0040204	アクティブな VM が多すぎます。
VM_E_VM_RUNNING 0xA0040500	VM は既に実行されています。
DISP_E_EXCEPTION 0x80020009	予期しないエラーが発生しました。

返された IVMTask オブジェクトの Error プロパティを使用して、次の値を返すことができます。

エラーコード/値	説明
`VM_E_UNSUPPORTED_HARDWARE` (0xA0040950)	ハードウェアは仮想化をサポートしていません。
`VM_E_HARDWARE_VIRTUALIZATION_DISABLED` (0xA0040951)	ハードウェア仮想化が無効になっています。
`VM_E_VMVIRTUALPC_OLDER_VERSION` (0xA0040952)	Virtual PC 2007 と Windows Virtual PC の両方がインストールされています。
`VM_E_OTHER_VIRTUALIZATION_SOFTWARE` (0xA0040953)	その他の仮想化ソフトウェアがインストールされています。
`VM_E_OUT_OF_RESOURCE` (0xa00400203)	十分なホストリソースがありません。

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
クライアントサポートの終了	Windows 7
製品	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	IID_IVMVirtualMachineは f7092aa1-33ed-4f78-a59f-c00adfc2edd7 として定義されています