IVMGuestOS::HeartbeatPercentage プロパティ
[Windows Virtual PC は、Windows 8の時点で使用できなくなりました。 代わりに、 Hyper-V WMI プロバイダー (V2) を使用します。
過去 1 分間に受信した予想ハートビートの割合を取得します。
このプロパティは読み取り専用です。
構文
HRESULT get_HeartbeatPercentage(
[out, retval] long *heartbeatPercentage
);
プロパティ値
過去 1 分間に受信した予想ハートビートの割合。
エラー コード
| 名前/値 | 説明 |
|---|---|
|
操作に成功しました。 |
|
パラメーターが NULL です。 |
|
構成が不明です。 |
|
この操作には、仮想マシン (VM) が実行されている必要があります。 |
|
VM が完全に起動されていないか、統合コンポーネント機能がインストールされていないか、インストールされているバージョンがこの機能をサポートしていません。 |
|
予期しないエラーが発生しました。 |
解説
統合コンポーネントは、ゲスト オペレーティング システムの実行中に Windows Virtual PC に定期的なハートビートを送信します。 ゲスト オペレーティング システムが大量に読み込まれている場合は、Windows Virtual PC の受信ハートビートが予想よりも少なくなる可能性があります。 ハートビートの割合が 0 に低下した場合は、ゲスト オペレーティング システムが応答していないか、クラッシュしている可能性があります。 仮想マシンが実行されている (つまり、完全に起動され、シャットダウンされていない) 必要があり、このプロパティが呼び出されたときに統合コンポーネントをインストールする必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| クライアント サポートの終了 |
Windows 7 |
| Product |
Windows Virtual PC |
| ヘッダー |
|
| IID |
IID_IVMGuestOSは 99fea0db-4880-499a-b6d8-73dff9bc91be として定義されています |