MÉTHODE IVMVirtualPC::FindVirtualMachine

  • Article

[Windows Virtual PC n’est plus disponible à partir de Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]

Récupère un objet de machine virtuelle qui correspond à la configuration demandée.

Syntaxe

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

Paramètres

configurationName [in]

Nom de la machine virtuelle à trouver.

virtualMachine [out, retval]

Pointeur vers un nouvel objet IVMVirtualMachine qui représente cette machine virtuelle.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code/valeur de retour Description
S_OK
0
 L'opération a réussi.
S_FALSE
1
 La configuration spécifiée est introuvable.
E_POINTER
0x80004003
 Le paramètre configurationName n’est pas valide ou virtualMachine a la valeur NULL.
DISP_E_EXCEPTION
0x80020009
 Une erreur inattendue s’est produite.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 Le processeur ne prend pas en charge les extensions HAV (Hardware Accelerated Virtualization).

Notes

Les noms de machines virtuelles ne respectent pas la casse, par exemple, « MyVM » et « myvm » font référence à la même machine virtuelle.

Spécifications

Condition requise Valeur
Client minimal pris en charge
 Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge
 Aucun pris en charge
Fin de la prise en charge des clients
 Windows 7
Produit
 Windows Virtual PC
En-tête
VPCCOMInterfaces.h
IID
 IID_IVMVirtualPC est défini comme 236ba0d9-a24a-4292-a132-27c1421dfd01

Voir aussi

IVMVirtualPC