Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Retrieves a configuration parameter inside the guest operating system.
Syntax
HRESULT GetParameter(
[in] BSTR inParameterName,
[out] BSTR *outParameterValue
);
Parameters
-
inParameterName [in]
-
The parameter name. It must be between 1 and 255 characters in length and cannot contain a backslash () character.
-
outParameterValue [out]
-
The parameter value.
Return value
This method can return one of these values.
| Return code | Description |
|---|---|
|
The operation was successful. |
|
The outParameterValue parameter is not valid or not specified. |
|
The virtual machine is not running. |
|
The virtual machine is paused. |
|
Additions are not installed in this virtual machine. |
|
An unexpected error has occurred. |
Remarks
The virtual machine must be running and Additions must be installed when this method is invoked. This method is supported only for Windows-based guest operating systems.
With Additions installed, the following key is automatically added to the guest operating system's registry:
- HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Virtual Machine\Guest\Parameters
When the guest operating system starts, the following registry string values are populated in the Parameters key:
- HostName
- PhysicalHostName
- PhysicalHostNameFullyQualified
- VirtualMachineName
Requirements
| Download |
Microsoft Virtual Server 2005 R2 SP1 Update onWindows Server 2008orWindows Server 2003 |
| Header |
|