IVMHardDisk::Parent property

  • Article

The Parent property contains the IVMHardDisk object associated with the parent hard disk image.

This property is read/write.

Syntax

HRESULT put_Parent(
  [in]  IVMHardDisk *parent
);

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

VB 
VMHardDisk.Parent( _
  ByRef parent, _
  ByVal parent _
)

Property value

The VMHardDisk object associated with the parent hard disk image.

This property value is read/write.

Error codes

Name Meaning
S_OK
 The operation was successful.
E_POINTER
 The parent parameter is NULL.
S_FALSE
 This is not a differencing hard disk, so it has no parent.
E_FILE_NOT_FOUND
 The system could not find the parent virtual hard disk file.
E_PATH_NOT_FOUND
 The system could not find the path to the parent virtual hard disk file.
VM_E_PREF_READ_ERROR
 The preferences for the current hard disk image could not be read.
VM_E_HD_IMAGE_OPEN_FAIL
 An error occurred while attempting to open the current hard disk image file.
VM_E_HD_IMAGE_ACCESS
 An error occurred while attempting to access the current hard disk image file.
VM_E_PARENT_CHILD_ID_MISMATCH
 The virtual hard disk image located by the parameter parent does not have the same ID as the child disk image. Make sure the parent virtual hard disk image located by parent is the same image used to create the differencing virtual hard disk image.
DISP_E_EXCEPTION
 An unexpected error occurred.

Remarks

This property is only valid with differencing hard disk images.

Requirements
Product
 Microsoft Virtual Server 2005 onWindows Server 2003
Download
 Microsoft Virtual Server 2005 R2 SP1 Update onWindows Server 2008orWindows Server 2003
Header
VsComInterfaces.h

See also

IVMHardDisk