Compartir a través de

IVMHardDisk::MergeTo (método)

  • Artículo

[Windows Virtual PC ya no está disponible para su uso a partir de Windows 8. En su lugar, use el proveedor WMI de Hyper-V (V2)].

Combina un disco duro virtual de diferenciación con todos sus elementos primarios (hasta y incluido el disco duro virtual principal raíz) en un nuevo archivo de disco duro.

Sintaxis

HRESULT MergeTo(
  [in]          BSTR           newDiskImagePath,
  [in]          VMHardDiskType newDiskImageType,
  [out, retval] IVMTask        **mergeTask
);

Parámetros

newDiskImagePath [in]

Ruta de acceso a la nueva imagen de disco de destino donde se combinarán las imágenes de disco seleccionadas.

newDiskImageType [in]

Tipo de nueva imagen de disco de destino. Los tipos de imagen permitidos para la nueva imagen de disco de destino se vmDiskType_Dynamic y vmDiskType_FixedSize. Para más información, consulte VMHardDiskType.

mergeTask [out, retval]

Objeto IVMTask que se usa para realizar un seguimiento de la finalización del proceso de combinación.

Valor devuelto

Este método puede devolver uno de estos valores.

Código o valor devuelto Descripción
S_OK
0
 La operación se realizó correctamente.
E_POINTER
0x80004003
 Un parámetro es NULL.
E_INVALIDARG
0x80000003
 El nuevo parámetroDiskImagePath está vacío.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 El sistema no encuentra el archivo especificado por el parámetro newDiskImagePath .
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 El sistema no encuentra la ruta de acceso especificada por el parámetro newDiskImagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 El parámetro newDiskImagePath contiene un carácter no válido (uno de los siguientes: "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 El parámetro newDiskImagePath especifica una ruta de acceso vacía o relativa. Se requiere una ruta de acceso absoluta.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW)
0x8007006f
 La ruta de acceso especificada por el parámetro newDiskImagePath es demasiado larga. La ruta de acceso debe tener menos de 260 caracteres.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
 El disco duro virtual al que hace referencia este objeto está en uso o el elemento primario de este disco duro virtual está en uso.
VM_E_WRONG_HD_IMAGE_TYPE
0xA004067B
 Este error se debe a que la imagen de disco duro virtual a la que hace referencia este objeto IVMHardDisk no es una imagen de disco de diferenciación o porque el parámetro newDiskImageType no es uno de los valores aceptados, vmDiskType_Dynamic o vmDiskType_FixedSize.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 El archivo al que hace referencia el parámetro newDiskImagePath ya existe.
HRESULT_FROM_WIN32(ERROR_DISK_FULL)
0x80070070
 El volumen de host no tiene suficiente espacio para combinar este disco duro virtual.
VM_E_PARENT_PATH_NOT_FOUND
0xA0040677
 El elemento primario del disco duro virtual al que hace referencia este objeto no existe.
VM_E_APP_SHUTTING_DOWN
0xA0040209
 No se puede combinar la imagen del disco duro virtual porque la aplicación se está cerrando.
DISP_E_EXCEPTION
0x80020009
 Se produjo un error inesperado.

Requisitos

Requisito Value
Cliente mínimo compatible
 Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible
 No se admite ninguno
Fin de compatibilidad de cliente
 Windows 7
Producto
 Windows Virtual PC
Encabezado
VPCCOMInterfaces.h
IID
 IID_IVMHardDisk se define como ffa14ae6-48f5-42a4-8a22-186f2e5c7db0

Consulte también

IVMHardDisk