Compartir a través de

IVMVirtualPC::RegisterVirtualMachine (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)].

Registra una configuración de máquina virtual existente y recupera el objeto de máquina virtual.

Sintaxis

HRESULT RegisterVirtualMachine(
  [in]          BSTR              configurationName,
  [in]          BSTR              configurationPath,
  [out, retval] IVMVirtualMachine **virtualMachine
);

Parámetros

configurationName [in]

Nombre de la máquina virtual que se va a registrar. La longitud del nombre no puede superar los 80 caracteres y la longitud combinada del nombre y la ruta de acceso no pueden superar MAX_PATH (260) caracteres. El nombre especificado puede contener la extensión .vmc. Si este parámetro es NULL o una cadena vacía, el parámetro configurationPath debe especificar la ruta de acceso completa al archivo de configuración.

configurationPath [in]

Ruta de acceso a la carpeta que contiene el archivo de configuración existente. Si el parámetro configurationName es NULL o una cadena vacía, debe especificar la ruta de acceso completa al archivo de configuración existente.

virtualMachine [out, retval]

Puntero a un nuevo objeto IVMVirtualMachine que representa esta máquina virtual.

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 configurationName o configurationPath no es válido o virtualMachine es NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND)
0x80070003
 El sistema no encuentra la ruta de acceso especificada por los parámetros configurationName y configurationPath .
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 El sistema no encuentra el archivo especificado por los parámetros configurationName y configurationPath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME)
0x8007007b
 El parámetro configurationPath contiene un carácter no válido (uno de "*?:<>/|"").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME)
0x800700a1
 El parámetro configurationPath 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 los parámetros configurationName y configurationPath da como resultado una ruta de acceso demasiado larga. La longitud combinada de la ruta de acceso debe ser menor que MAX_PATH (260) caracteres.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
0x800700b7
 Ya existe un archivo de configuración con este nombre en esta ubicación.
VM_E_CONFIG_NAME_TOO_LONG
0xA0040401
 El parámetro configurationName supera los 80 caracteres de longitud.
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
 El parámetro configurationName contiene un carácter no válido (uno de "*?:<>/|\"").
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
 Ya hay una máquina virtual con este nombre.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 El procesador no admite extensiones de virtualización acelerada de hardware (HAV).
DISP_E_EXCEPTION
0x80020009
 Se produjo un error inesperado.

Comentarios

Los nombres de máquina virtual no distinguen mayúsculas de minúsculas; por ejemplo, "MyVM" y "myvm" hacen referencia a la misma máquina virtual.

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_IVMVirtualPC se define como 236ba0d9-a24a-4292-a132-27c1421dfd01

Consulte también

IVMVirtualPC