IVMVirtualPC::GetHardDisk method

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

Retrieves an object corresponding to an existing disk image file.

Syntax

HRESULT GetHardDisk(
  [in]          BSTR        imagePath,
  [out, retval] IVMHardDisk **hardDisk
);

Parameters

imagePath [in]

The full path to an existing disk image file.

hardDisk [out, retval]

An IVMHardDisk object corresponding to this disk image.

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 imagePath or hardDisk parameter is NULL.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
The system cannot find the file specified by the imagePath parameter.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
The system cannot find the path specified by the imagePath parameter.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
The imagePath parameter contains an invalid character (one of "*?:<>/|"").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
The imagePath parameter specifies an empty or relative path. An absolute path is required.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
The path specified by the imagePath parameter is too long. The length of the path must be less than 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.

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