IVMVirtualMachine::AddHardDiskConnection (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).]

Agrega una nueva conexión de disco duro a la máquina virtual (VM).

Sintaxis

HRESULT AddHardDiskConnection(
  [in]          BSTR                  hardDiskPath,
  [in]          long                  busNumber,
  [in]          long                  deviceNumber,
  [out, retval] IVMHardDiskConnection **hardDiskConnection
);

Parámetros

hardDiskPath [in]

Ruta de acceso completa del archivo de disco duro virtual (VHD) que se va a conectar.

busNumber [in]

El autobús al que se conectará la unidad.

Valor Significado
0
 La unidad se conectará al primer autobús.
1
 La unidad se conectará al segundo autobús.

deviceNumber [in]

Dispositivo al que se conectará la unidad.

Valor Significado
0
 La unidad se conectará al primer dispositivo del bus.
1
 La unidad se conectará al segundo dispositivo del bus.

hardDiskConnection [out, retval]

Objeto IVMHardDiskConnection .

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
 El parámetro hardDiskConnection es NULL.
E_INVALIDARG
0x80000003
 Un parámetro hardDiskPath es NULL o el parámetro busNumber o deviceNumber no es válido.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 El sistema no encuentra el archivo especificado por el parámetro hardDiskPath .
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 El sistema no encuentra la ruta de acceso especificada por el parámetro hardDiskPath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 El parámetro hardDiskPath contiene un carácter no válido (uno de "*?<> /|":").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 El parámetro hardDiskPath 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 hardDiskPath es demasiado larga. La ruta de acceso debe tener menos de 260 caracteres.
VM_E_VM_UNKNOWN
0xA0040207
 La configuración es desconocida.
VM_E_VM_RUNNING_OR_SAVED
0xA004020B
 La máquina virtual está en un estado en ejecución o guardado.
VM_E_DRIVE_BUS_LOC_IN_USE
0xA00400503
 La ubicación de autobús especificada está en uso.
VM_E_INVALID_HD_FILE
0xA0040682
 El disco duro virtual es mayor que 127 GB y no se puede conectar al bus IDE.
VM_E_UNSUPPORTED_HD_DISK_TYPE
0xA00400686
 El parámetro hardDiskPath hace referencia a un VHD vinculado o a un VHD de diferenciación a un VHD vinculado. Los VHD vinculados no se pueden conectar a máquinas virtuales.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
 El disco duro virtual especificado ya está conectado a otra ubicación de bus para esta máquina virtual.
DISP_E_EXCEPTION
0x80020009
 Se produjo un error inesperado.

Comentarios

Solo puede agregar una nueva conexión de disco duro a una máquina virtual detenida.

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_IVMVirtualMachine se define como f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Consulte también

IVMVirtualMachine