IVMVirtualMachine::AddHardDiskConnection (Método)

[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