IVMGuestOS-Schnittstelle

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]

Definiert das Gastbetriebssystem, das auf einem virtuellen Computer ausgeführt wird. Über diese Schnittstelle können Sie mit den Integrationskomponenten interagieren, die im Gastbetriebssystem ausgeführt werden. IvMGuestOS für einen virtuellen Computer kann mithilfe der IVMVirtualMachine::GuestOS-Eigenschaft abgerufen werden.

Member

Die IVMGuestOS-Schnittstelle erbt von der IDispatch-Schnittstelle . IVMGuestOS verfügt auch über folgende Membertypen:

• Methoden
• Eigenschaften

Methoden

Die IVMGuestOS-Schnittstelle verfügt über diese Methoden.

Methode	BESCHREIBUNG
GetOsVersionInfo	Ruft Versionsinformationen für das Gastbetriebssystem ab, das auf dem virtuellen Computer ausgeführt wird.
Dbparametercollection.getparameter	Ruft einen benannten Parameter innerhalb des Gasts ab.
InstallIntegrationComponents	Sucht und installiert die neuesten Integrationskomponenten im Gastbetriebssystem.
IsUserLoggedOn	Bestimmt, ob die angeforderte Sitzung vorhanden ist.
Abmelden	Meldet alle Benutzer vom Gastbetriebssystem ab.
Neu starten	Startet das Gastbetriebssystem neu.
SetParameter	Legt einen benannten Parameter innerhalb des Gasts fest.
Herunterfahren	Beendet das Gastbetriebssystem.

Eigenschaften

Die IVMGuestOS-Schnittstelle verfügt über diese Eigenschaften.

Eigenschaft	Zugriffstyp	BESCHREIBUNG
Canshutdown	Schreibgeschützt	Gibt an, ob das Gastbetriebssystem sauber heruntergefahren werden kann (erfordert Integrationskomponenten).
ComputerName	Schreibgeschützt	Der Computername des Gastbetriebssystems, das auf dem virtuellen Computer ausgeführt wird.
CSDVersion	Schreibgeschützt	Die CSDVersion des Gastbetriebssystems, das auf dem virtuellen Computer ausgeführt wird.
HeartbeatPercentage	Schreibgeschützt	Der Prozentsatz der erwarteten Takte, die in der letzten Minute empfangen wurden.
IntegrationComponentsVersion	Schreibgeschützt	Die Version der integrationskomponenten, die im Gastbetriebssystem installiert sind.
IsHeartbeating	Schreibgeschützt	Gibt an, ob der virtuelle Computer über einen Heartbeat verfügt.
IsHostTimeSyncEnabled	Lesen/Schreiben	Gibt an, ob die Integrationskomponenten auf diesem virtuellen Computer die Uhr des Gasts mit der Uhr des Hosts synchronisieren sollen.
MultipleUserSessionsAllowed	Schreibgeschützt	Gibt an, ob mehrere gleichzeitige Benutzersitzungen im Gastbetriebssystem zulässig sind.
OSBuildNumber	Schreibgeschützt	Die Buildnummer des Gastbetriebssystems, das auf dem virtuellen Computer ausgeführt wird.
OSMajorVersion	Schreibgeschützt	Die Hauptversion des Gastbetriebssystems, das auf dem virtuellen Computer ausgeführt wird.
OSMinorVersion	Schreibgeschützt	Die Nebenversion des Gastbetriebssystems, das auf dem virtuellen Computer ausgeführt wird.
OSName	Schreibgeschützt	Der Name des Gastbetriebssystems, das auf dem virtuellen Computer ausgeführt wird.
OSPlatformId	Schreibgeschützt	Der Plattformbezeichner des Gastbetriebssystems, das auf dem virtuellen Computer ausgeführt wird.
OSVersion	Schreibgeschützt	Die Version des Gastbetriebssystems, das auf dem virtuellen Computer ausgeführt wird.
ProductType	Schreibgeschützt	Der Produkttyp des Gastbetriebssystems, das auf dem virtuellen Computer ausgeführt wird.
ScreenLocked	Schreibgeschützt	Gibt an, ob der Bildschirm im Gastbetriebssystem gesperrt ist.
ServicePackMajor	Schreibgeschützt	Die Hauptversion des Service Packs des Gastbetriebssystems, das auf dem virtuellen Computer ausgeführt wird.
ServicePackMinor	Schreibgeschützt	Die Nebenversion des Service Packs des Gastbetriebssystems, das auf dem virtuellen Computer ausgeführt wird.
SuiteMask	Schreibgeschützt	SuiteMask des Gastbetriebssystems, das auf dem virtuellen Computer ausgeführt wird.
TerminalServerPort	Schreibgeschützt	Port, der von Remotedesktopdiensten im Gastbetriebssystem verwendet wird.
TerminalServicesInitialized	Schreibgeschützt	Die status der Terminaldiensteinitialisierung im Gastbetriebssystem.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Ende des Supports (Client)	Windows 7
Produkt	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	IID_IVMGuestOS ist definiert als 99fea0db-4880-499a-b6d8-73dff9bc91be