Edit

IVMVirtualPC::GetVirtualMachineFiles method

  • Article

[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