IVMVirtualMachine::Save メソッド

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

仮想マシン (VM) の状態を保存します。

構文

HRESULT Save(
  [out, retval] IVMTask **saveTask
);

パラメーター

saveTask [out, retval]

VM の状態保存シーケンスの完了の進行状況を追跡するために使用される IVMTask オブジェクト。

戻り値

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

リターン コード/値 説明
S_OK
0
操作に成功しました。
E_FAIL
0x80004005
元に戻すディスクが削除対象としてマークされているため、VM を保存できませんでした。
E_POINTER
0x80004003
パラメーターが NULL です
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED)
0x80070005
この VM の状態を保存するには、呼び出し元に実行アクセス許可が必要です。
VM_E_VM_NOT_RUNNING
0xA0040206
VM が実行されていません。
DISP_E_EXCEPTION
0x80020009
予期しないエラーが発生しました。

解説

保存タスクが完了すると、VM はオフになります。 IVMVirtualMachine::State プロパティには、保存の進行中にvmVMState_Savingが含まれます。その後、保存が完了し、VM がオフになったときにvmVMState_Savedが続きます。

必要条件

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

関連項目

IVMVirtualMachine