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
ヘッダー
VPCCOMInterfaces.h
IID
IID_IVMGuestOSは 99fea0db-4880-499a-b6d8-73dff9bc91be として定義されています