IVMGuestOS::HeartbeatPercentage プロパティ

  • [アーティクル]

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

過去 1 分間に受信した予想ハートビートの割合を取得します。

このプロパティは読み取り専用です。

構文

HRESULT get_HeartbeatPercentage(
  [out, retval] long *heartbeatPercentage
);

プロパティ値

過去 1 分間に受信した予想ハートビートの割合。

エラー コード

名前/値 説明
S_OK
0
 操作に成功しました。
E_POINTER
0x80004003
 パラメーターが NULL です。
VM_E_VM_UNKNOWN
0xA0040207
 構成が不明です。
VM_E_VM_NOT_RUNNING
0xA0040206
 この操作には、仮想マシン (VM) が実行されている必要があります。
VM_E_ADDITIONS_NOT_AVAIL
0xA0040504
 VM が完全に起動されていないか、統合コンポーネント機能がインストールされていないか、インストールされているバージョンがこの機能をサポートしていません。
DISP_E_EXCEPTION
0x80020009
 予期しないエラーが発生しました。

解説

統合コンポーネントは、ゲスト オペレーティング システムの実行中に Windows Virtual PC に定期的なハートビートを送信します。 ゲスト オペレーティング システムが大量に読み込まれている場合は、Windows Virtual PC の受信ハートビートが予想よりも少なくなる可能性があります。 ハートビートの割合が 0 に低下した場合は、ゲスト オペレーティング システムが応答していないか、クラッシュしている可能性があります。 仮想マシンが実行されている (つまり、完全に起動され、シャットダウンされていない) 必要があり、このプロパティが呼び出されたときに統合コンポーネントをインストールする必要があります。

要件

要件 値
サポートされている最小のクライアント
 Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
クライアント サポートの終了
 Windows 7
Product
 Windows Virtual PC
ヘッダー
VPCCOMInterfaces.h
IID
 IID_IVMGuestOSは 99fea0db-4880-499a-b6d8-73dff9bc91be として定義されています

関連項目

IVMGuestOS