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 |
---|---|
|
The operation was successful. |
|
The imagePath or hardDisk parameter is NULL. |
|
The system cannot find the file specified by the imagePath parameter. |
|
The system cannot find the path specified by the imagePath parameter. |
|
The imagePath parameter contains an invalid character (one of "*?:<>/|""). |
|
The imagePath parameter specifies an empty or relative path. An absolute path is required. |
|
The path specified by the imagePath parameter is too long. The length of the path must be less than 260 characters. |
|
An unexpected error has occurred. |
|
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 |
|
IID |
IID_IVMVirtualPC is defined as 236ba0d9-a24a-4292-a132-27c1421dfd01 |