The FindVirtualMachine method returns a virtual machine object matching the requested configuration.
Syntax
HRESULT FindVirtualMachine(
[in] BSTR configurationName,
[out] IVMVirtualMachine **virtualMachine
);
Parameters
-
configurationName [in]
-
The name of the virtual machine to find.
-
virtualMachine [out]
-
A pointer to a new IVMVirtualMachine object which represents this virtual machine.
Return value
This method can return one of these values.
| Return code | Description |
|---|---|
|
The operation was successful. |
|
The specified configuration could not be found. |
|
configurationName is invalid, or virtualMachine is NULL. |
|
An unexpected error has occurred. |
Remarks
Virtual machine names are case-insensitive, for example, "MyVM" and "myvm" refer to the same virtual machine.
Requirements
| Product |
Microsoft Virtual Server 2005 onWindows Server 2003 |
| Download |
Microsoft Virtual Server 2005 R2 SP1 Update onWindows Server 2008orWindows Server 2003 |
| Header |
|