IVMGuestOS::IsHeartbeating プロパティ
[Windows Virtual PC は Windows 8 の時点で使用できなくなりました。 代わりに、Hyper-V WMI プロバイダー (V2) を使用してください。]
仮想マシンにハートビートがあるかどうかを判断します。
このプロパティは読み取り専用です。
構文
HRESULT get_IsHeartbeating(
[out, retval] VARIANT_BOOL *heartBeating
);
プロパティ値
ハートビートが検出された場合はVARIANT_TRUE、それ以外の場合はVARIANT_FALSE です。
エラー コード
| 名前/値 | 意味 |
|---|---|
|
操作に成功しました。 |
|
パラメーターが NULL です。 |
|
構成が不明です。 |
|
この操作では、仮想マシンが実行されている必要があります。 |
|
仮想マシンが完全に起動されていないか、統合コンポーネント機能がインストールされていないか、インストールされているバージョンではこの機能がサポートされていません。 |
|
予期しないエラーが発生しました。 |
解説
ゲスト オペレーティング システムに統合コンポーネントがインストールされると、仮想マシン セッションから 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 |
| ヘッダー |
|
| IID |
IID_IVMGuestOS は 99fea0db-4880-499a-b6d8-73dff9bc91be として定義されます |