IVMGuestOS::GetParameter-Methode

  • Artikel

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

Ruft einen benannten Parameter innerhalb des Gastbetriebssystems ab.

Syntax

HRESULT GetParameter(
  [in]          BSTR inParameterName,
  [out, retval] BSTR *outParameterValue
);

Parameter

inParameterName [in]

Der Name des Parameters. Er muss zwischen 1 und 255 Zeichen lang sein und darf keinen umgekehrten Schrägstrich (\) enthalten.

outParameterValue [out, retval]

Der Parameterwert.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert BESCHREIBUNG
S_OK
0
 Der Vorgang wurde durchgeführt.
E_INVALIDARG
0x80000003
 Ein Parameter ist ungültig oder nicht angegeben.
E_POINTER
0x80004003
 Der Parameter ist NULL.
VM_E_TIMED_OUT
0xA0040202
 Der Vorgang wurde nicht rechtzeitig abgeschlossen.
VM_E_VM_NOT_RUNNING
0xA0040206
 Der virtuelle Computer wird nicht ausgeführt.
VM_E_VM_PAUSED
0xA00400507
 Der virtuelle Computer wird angehalten.
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

Der virtuelle Computer muss ausgeführt werden, und integrationskomponenten müssen installiert sein, wenn diese Methode aufgerufen wird. Diese Methode wird nur für Windows-basierte Gastbetriebssysteme unterstützt.

Wenn Integrationskomponenten installiert sind, wird der Folgende Schlüssel automatisch der Registrierung des Gastbetriebssystems hinzugefügt:

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Virtual Machine\Guest\Parameters

Wenn das Gastbetriebssystem gestartet wird, werden die folgenden Registrierungszeichenfolgenwerte im Parameterschlüssel aufgefüllt:

  • HostName
  • PhysicalHostName
  • PhysicalHostNameFullyQualified
  • VirtualMachineName

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