IVMGuestOS::SetParameter-Methode
[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. 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 umgekehrten 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 wird angehalten. |
|
Integrationskomponenten werden auf diesem virtuellen Computer nicht installiert. |
|
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 |
|
| IID |
IID_IVMGuestOS ist definiert als 99fea0db-4880-499a-b6d8-73dff9bc91be |