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
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 |
|
| IID |
IID_IVMGuestOS ist definiert als 99fea0db-4880-499a-b6d8-73dff9bc91be |