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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Ein Parameter ist ungültig oder nicht angegeben. |
|
Der Vorgang wurde nicht rechtzeitig abgeschlossen. |
|
Der virtuelle Computer (VM) wird nicht ausgeführt. |
|
Der virtuelle Computer wurde angehalten. |
|
Integrationskomponenten sind auf diesem virtuellen Computer nicht installiert. |
|
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 |
|
| IID |
IID _ IVMGuestOS ist als 99fea0db-4880-499a-b6d8-73dff9bc91be definiert. |