IVMVirtualPC::GetVirtualMachineFiles method

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

Retrieves an array of known virtual machine configuration files.

Syntax

HRESULT GetVirtualMachineFiles(
  [in]          VARIANT      inAdditionalSearchPaths,
  [in]          VARIANT_BOOL inExcludedRegisteredVMs,
  [out, retval] VARIANT      *outVirtualMachineFileList
);

Parameters

inAdditionalSearchPaths [in]

These paths will be searched along with the paths set in the IVMVirtualPC::SearchPaths and IVMVirtualPC::DefaultVMConfigurationPath properties.

inExcludedRegisteredVMs [in]

TRUE if registered virtual machines should be excluded from the array return in the outVirtualMachineFileList parameter and FALSE otherwise.

outVirtualMachineFileList [out, retval]

An array of path strings for the virtual machine configuration files found in the specified search paths.

Return value

This method can return one of these values.

Return code/value	Description
S_OK 0	The operation was successful.
E_POINTER 0x80004003	The outVirtualMachineFileList parameter is NULL.
E_INVALIDARG 0x80000003	The inAdditionalSearchPaths parameter is not an array of strings.
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

The search paths used to retrieve the array of configuration files will include those set previously by IVMVirtualPC::SearchPaths and IVMVirtualPC::DefaultVMConfigurationPath in addition to those specified by the inAdditionalSearchPaths parameter.

Requirements

Requirement	Value
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