Compartir a través de

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

Recupera un objeto de máquina virtual que coincide con la configuración solicitada.

Sintaxis

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

Parámetros

configurationName [in]

Nombre de la máquina virtual que se va a encontrar.

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.
S_FALSE
1
 No se encontró la configuración especificada.
E_POINTER
0x80004003
 El parámetro configurationName no es válido o virtualMachine es NULL.
DISP_E_EXCEPTION
0x80020009
 Se produjo un error inesperado.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 El procesador no admite extensiones de virtualización acelerada de hardware (HAV).

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