Export (0) Print
Expand All

IVMVirtualPC::FindVirtualMachine method

Windows Virtual PC

[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]

Retrieves a virtual machine object that matches the requested configuration.

Syntax


HRESULT FindVirtualMachine(
  [in]           BSTR configurationName,
  [out, retval]  IVMVirtualMachine **virtualMachine
);

Parameters

configurationName [in]

The name of the virtual machine to be found.

virtualMachine [out, retval]

A pointer to a new IVMVirtualMachine object that represents this virtual machine.

Return value

This method can return one of these values.

Return code/valueDescription
S_OK
0

The operation was successful.

S_FALSE
1

The specified configuration could not be found.

E_POINTER
0x80004003

The configurationName parameter is invalid, or virtualMachine is NULL.

DISP_E_EXCEPTION
0x80020009

An unexpected error has occurred.

VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951

The processor does not support Hardware Accelerated Virtualization (HAV) extensions.

 

Remarks

Virtual machine names are case-insensitive, for example, "MyVM" and "myvm" refer to the same virtual machine.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

None supported

End of client support

Windows 7

Product

Windows Virtual PC

Header

VPCCOMInterfaces.h

IID

IID_IVMVirtualPC is defined as 236ba0d9-a24a-4292-a132-27c1421dfd01

See also

IVMVirtualPC

 

 

Community Additions

ADD
Show:
© 2014 Microsoft