IVMGuestOS::IsHeartbeating プロパティ

  • [アーティクル]

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

仮想マシンにハートビートがあるかどうかを判断します。

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

構文

HRESULT get_IsHeartbeating(
  [out, retval] VARIANT_BOOL *heartBeating
);

プロパティ値

ハートビートが検出された場合はVARIANT_TRUE、それ以外の場合はVARIANT_FALSE です。

エラー コード

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

解説

ゲスト オペレーティング システムに統合コンポーネントがインストールされると、仮想マシン セッションから Windows Virtual PC に通常の "ティック" またはハートビートが送信されます。 ゲスト オペレーティング システムが頻繁に読み込まれている場合、仮想 PC が受信するハートビートの数が予想よりも少なくなる可能性があります。 ハートビートが検出されない場合は、ゲスト オペレーティング システムが応答していないか、クラッシュしている可能性があります。

既定では、仮想マシンは 1 分あたり 10 回のハートビート ティックを生成します。 1 分間ハートビート ティックが検出されない場合、Windows Virtual PC は最大 2 分間、10 秒ごとに 1 回仮想マシン セッションの再起動を試みます。 この動作は、仮想マシン セッションの構成ファイル内の次のキー値によって制御されます。

構成キー 既定値 説明
integration/microsoft/heartbeat/time
 60
 ハートビート ティックの生成に使用される時間ブロックの長さです (秒単位)。
integration/microsoft/heartbeat/rate
 10
 各ハートビー 時間ブロックで生成されたティックの数です。
integration/microsoft/heartbeat/failure_interval
 10
 特定のハートビート時間ブロック内でハートビート ティックが受信されない場合の再起動の試行間隔です (秒数)。
integration/microsoft/heartbeat/failure_attempts
 12
 実行された再起動の試行回数です。

必要条件

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

関連項目

IVMGuestOS