IVMGuestOS::SetParameter-Methode

[Windows Der virtuelle PC ist ab diesem Zeitraum nicht mehr Windows 8. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (V2).]

Legt einen benannten Parameter innerhalb des Gastbetriebssystems fest.

Syntax

HRESULT SetParameter(
  [in] BSTR inParameterName,
  [in] BSTR inParameterValue
);

Parameter

inParameterName [ In]

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

inParameterValue [ In]

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.
VM _ E _ TIMED _ OUT
0xA0040202
Der Vorgang wurde nicht rechtzeitig abgeschlossen.
VM _ E _ VM _ NOT _ RUNNING
0xA0040206
Der virtuelle Computer (VM) wird nicht ausgeführt.
VM _ E _ VM _ PAUSED
0xA00400507
Der virtuelle Computer wurde angehalten.
VM _ E _ ADDITIONS _ FEATURE NOT _ _ AVAIL
0XA0040505
Integrationskomponenten sind auf diesem virtuellen Computer nicht installiert.
DISP _ E _ EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Die VM muss ausgeführt werden, und Integrationskomponenten müssen installiert werden, wenn diese Methode aufgerufen wird. Diese Methode wird nur für Windows Gastbetriebssysteme unterstützt.

Wenn Integrationskomponenten installiert sind, wird der folgende Schlüssel automatisch zur 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 [ 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 als 99fea0db-4880-499a-b6d8-73dff9bc91be definiert.

Siehe auch

IVMGuestOS