IVMGuestOS インターフェイス
[Windows Virtual PC は、Windows 8の時点で使用できなくなります。 代わりに、 Hyper-V WMI プロバイダー (V2)を使用します。
仮想マシン内で実行されているゲスト オペレーティング システムを定義します。 このインターフェイスを使用すると、ゲスト オペレーティング システム内で実行されている統合コンポーネントと対話できます。 仮想マシンの IVMGuestOS は、 IVMVirtualMachine::GuestOS プロパティを使用して取得できます。
IVMGuestOS インターフェイスは IDispatch インターフェイスから継承されます。 IVMGuestOS には、次の種類のメンバーもあります。
IVMGuestOS インターフェイスには、これらのメソッドがあります。
メソッド | 説明 |
---|---|
GetOsVersionInfo | 仮想マシンで実行されているゲスト オペレーティング システムのバージョン情報を取得します。 |
GetParameter | ゲスト内の名前付きパラメーターを取得します。 |
InstallIntegrationComponents | 最新の統合コンポーネントを見つけて、ゲスト オペレーティング システムにインストールします。 |
IsUserLoggedOn | 要求されたセッションが存在するかどうかを決定します。 |
ログオフ | ゲスト オペレーティング システムからすべてのユーザーをログオフします。 |
やり直し | ゲスト オペレーティング システムを再起動します。 |
SetParameter | ゲスト内の名前付きパラメーターを設定します。 |
シャット ダウン | ゲスト オペレーティング システムをシャットダウンします。 |
IVMGuestOS インターフェイスには、これらのプロパティがあります。
プロパティ | アクセスの種類 | 説明 |
---|---|---|
CanShutdown |
読み取り専用 |
ゲスト オペレーティング システムをクリーンにシャットダウンできるかどうかを示します (統合コンポーネントが必要です)。 |
ComputerName |
読み取り専用 |
仮想マシンで実行されているゲスト オペレーティング システムのコンピューター名。 |
CSDVersion |
読み取り専用 |
仮想マシンで実行されているゲスト オペレーティング システムの CSDVersion。 |
HeartbeatPercentage |
読み取り専用 |
過去 1 分間に受信した予想ハートビートの割合。 |
IntegrationComponentsVersion |
読み取り専用 |
ゲスト オペレーティング システムにインストールされている統合コンポーネントのバージョン。 |
IsHeartbeating |
読み取り専用 |
仮想マシンにハートビートがあるかどうかを示します。 |
IsHostTimeSyncEnabled |
読み取り/書き込み |
この仮想マシンの統合コンポーネントがゲストのクロックとホストのクロックを同期する必要があるかどうかを示します。 |
MultipleUserSessionsAllowed |
読み取り専用 |
ゲスト オペレーティング システムで複数の同時ユーザー セッションを許可するかどうかを示します。 |
OSBuildNumber |
読み取り専用 |
仮想マシンで実行されているゲスト オペレーティング システムのビルド番号。 |
OSMajorVersion |
読み取り専用 |
仮想マシンで実行されているゲスト オペレーティング システムのメジャー バージョン。 |
OSMinorVersion |
読み取り専用 |
仮想マシンで実行されているゲスト オペレーティング システムのマイナー バージョン。 |
OSName |
読み取り専用 |
仮想マシンで実行されているゲスト オペレーティング システムの名前。 |
OSPlatformId |
読み取り専用 |
仮想マシンで実行されているゲスト オペレーティング システムのプラットフォーム識別子。 |
OSVersion |
読み取り専用 |
仮想マシンで実行されているゲスト オペレーティング システムのバージョン。 |
ProductType |
読み取り専用 |
仮想マシンで実行されているゲスト オペレーティング システムの製品の種類。 |
ScreenLocked |
読み取り専用 |
ゲスト オペレーティング システムで画面がロックされているかどうかを示します。 |
ServicePackMajor |
読み取り専用 |
仮想マシンで実行されているゲスト オペレーティング システムのサービス パックのメジャー バージョン。 |
ServicePackMinor |
読み取り専用 |
仮想マシンで実行されているゲスト オペレーティング システムのサービス パックのマイナー バージョン。 |
SuiteMask |
読み取り専用 |
仮想マシンで実行されているゲスト オペレーティング システムの SuiteMask。 |
TerminalServerPort |
読み取り専用 |
ゲスト オペレーティング システムのリモート デスクトップ サービスによって使用されるポート。 |
TerminalServicesInitialized |
読み取り専用 |
ゲスト オペレーティング システムでのターミナル サービスの初期化の状態。 |
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 7 [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
サポートなし |
クライアント サポートの終了 |
Windows 7 |
製品 |
Windows Virtual PC |
ヘッダー |
|
IID |
IID_IVMGuestOSは 99fea0db-4880-499a-b6d8-73dff9bc91be として定義されています |