Freigeben über


IVMGuestOS::OSName-Eigenschaft

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

Ruft den Namen des Gastbetriebssystems ab, das auf dem virtuellen Computer (VM) ausgeführt wird.

Diese Eigenschaft ist schreibgeschützt.

Syntax

HRESULT get_OSName(
  [out, retval] BSTR *guestOSName
);

Eigenschaftswert

Der vollständige Name (einschließlich des Suitenamens) des Gastbetriebssystems.

Fehlercodes

Name/Wert Bedeutung
S_OK
0
Der Vorgang wurde durchgeführt.
E_POINTER
0x80004003
Der Parameter ist NULL.
VM_E_VM_NOT_RUNNING
0xA0040206
Der virtuelle Computer wird nicht ausgeführt.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
Integrationskomponenten werden auf diesem virtuellen Computer nicht installiert.
DISP_E_EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Die VM muss ausgeführt werden (d. h. vollständig gestartet und nicht heruntergefahren), und Integrationskomponenten müssen installiert werden, wenn diese Methode aufgerufen wird.

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

Weitere Informationen

IVMGuestOS