IVMHardDisk::Convert (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).]

Convierte un disco duro virtual de tamaño fijo en un disco duro virtual de expansión dinámica o convierte un disco duro virtual de expansión dinámica en un disco duro virtual de tamaño fijo.

Sintaxis

HRESULT Convert(
  [in]          BSTR           convertedDiskImagePath,
  [in]          VMHardDiskType convertedDiskImageType,
  [out, retval] IVMTask        **convertTask
);

Parámetros

convertedDiskImagePath [in]

Ruta de acceso al archivo de imagen de disco de destino.

convertedDiskImageType [in]

Tipo de la imagen de disco de destino. Para obtener una lista de valores, consulte VMHardDiskType.

convertTask [out, retval]

Objeto IVMTask que se usa para realizar un seguimiento de la finalización del proceso de conversió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_INVALIDARG
0x80000003
 El parámetro convertedDiskImagePath está vacío o falta la extensión .vhd en el nombre de archivo.
E_POINTER
0x80004003
 Un parámetro es NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 El sistema no encuentra la ruta de acceso especificada por el parámetro convertedDiskImagePath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 El parámetro convertedDiskImagePath contiene un carácter no válido (uno de "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 El parámetro convertedDiskImagePath 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 convertedDiskImagePath es demasiado larga. La ruta de acceso debe tener menos de MAX_PATH (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.
HRESULT_FROM_WIN32(ERROR_DISK_FULL)
0x80070070
 El volumen del host no tiene espacio suficiente para convertir este disco duro virtual.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 El archivo al que hace referencia el parámetro convertedDiskImagePath ya existe.
VM_E_WRONG_HD_IMAGE_TYPE
0xA004067B
 El parámetro convertedDiskImagePath debe ser vmDiskType_Dynamic o vmDiskType_FixedSize.
VM_E_INVALID_HD_FILE
0xA0040682
 La imagen del disco duro virtual a la que hace referencia este objeto IVMHardDisk no parece ser una imagen válida.
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 convertir la imagen del disco duro virtual porque la aplicación se está cerrando.
DISP_E_EXCEPTION
0x80020009
 Se produjo un error inesperado.

Observaciones

El archivo de origen se deja intacto después del proceso de conversión.

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

Vea también

IVMHardDisk