IVMHardDisk::Parent property

[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 parent of the differencing virtual hard disk.

This property is read/write.

Syntax

HRESULT put_Parent(
  [in]          IVMHardDisk *parent
);

HRESULT get_Parent(
  [out, retval] IVMHardDisk **parent
);

Sets the IVMHardDisk object associated with the parent hard disk image.

Name/value	Meaning
S_OK 0	The operation was successful.
E_POINTER 0x80004003	The parameter is NULL.
S_FALSE 1	This is not a differencing hard disk, so it has no parent.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	The system could not find the parent virtual hard disk file.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	The system could not find the path to the parent virtual hard disk file.
VM_E_HD_IMAGE_OPEN_FAIL 0xA004067C	An error occurred while attempting to open the current hard disk image file.
VM_E_HD_IMAGE_ACCESS 0xA0040681	An error occurred while attempting to access the current hard disk image file.
VM_E_PARENT_CHILD_ID_MISMATCH 0xA0040685	The virtual hard disk image located by the parent parameter does not have the same ID as the child disk image. Make sure the parent virtual hard disk image located by the parent parameter is the same image used to create the differencing virtual hard disk image.
DISP_E_EXCEPTION 0x80020009	An unexpected error has occurred.

This property is only valid with differencing hard disk images.

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_IVMHardDisk is defined as ffa14ae6-48f5-42a4-8a22-186f2e5c7db0

Was this page helpful?