IVMGuestOS::GetParameter-Methode
[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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Ein Parameter ist ungültig oder nicht angegeben. |
|
Der Parameter ist NULL. |
|
Der Vorgang wurde nicht rechtzeitig abgeschlossen. |
|
Der virtuelle Computer 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 |