Edit

IVMVirtualPC::DefaultVMConfigurationPath property

  • Article

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

Retrieves and sets the default directory to be searched for available virtual machine configuration files.

This property is read/write.

Syntax

HRESULT put_DefaultVMConfigurationPath(
  [in]          BSTR configurationPath
);

HRESULT get_DefaultVMConfigurationPath(
  [out, retval] BSTR *configurationPath
);

Property value

Specifies the directory path for the default virtual machine configuration files. In the path string, a backslash (\) may appear immediately before the terminating null character.

Error codes

Name/value Meaning
S_OK
0
 The operation was successful.
E_POINTER
0x80004003
 The configurationPath parameter is NULL.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 The system cannot find the directory specified by the configurationPath parameter.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 The system cannot find the path specified by the configurationPath parameter.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 The configurationPath parameter contains an invalid character (one of the following: "*?<>/|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 The configurationPath parameter specifies an empty or relative path. An absolute path is required.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 The path specified by the configurationPath parameter is too long. The length of the path must be less than MAX_PATH (260) characters.
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

By default, this property value is set to the following directory: "%LocalAppData%\Microsoft\Windows Virtual PC\Virtual Machines\".

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