IVMVirtualMachineEvents::OnRequestShutdown メソッド

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

シャットダウン要求が行われたという通知を受け取ります。

構文

HRESULT OnRequestShutdown();

パラメーター

このメソッドにはパラメーターはありません。

戻り値

このメソッドが成功すると、 S_OKが返されます。 それ以外の場合は、 HRESULT エラー コードが返されます。

解説

このメソッドは、仮想マシン セッションがシャットダウンしようとするたびに呼び出されます。 クライアント プログラムは、IVMVirtualMachine から発生したvmVirtualMachineEvent_RequestShutdown イベントの通知を受け取るために、このインターフェイス メソッドを実装する必要があります。

このイベント通知は、仮想マシン セッションがシャットダウンしようとしている場合にのみ送信されます。 IVMGuestOS::Shutdown などのオペレーティング システム シャットダウン ルーチンは、仮想ハードウェアのソフトウェア電源オフも実行しない限り、このイベントを直接起動しません。

必要条件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
クライアント サポートの終了	Windows 7
製品	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	DIID_IVMVirtualMachineEventsは 9d84f560-bb67-4961-bd12-a4da780c67e4 として定義されています

関連項目

IVMVirtualMachineEvents