MÉTHODE IVMVirtualPC::FindVirtualMachine

[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
);

configurationName [in]: Nom de la machine virtuelle à trouver.
virtualMachine [out, retval]: Pointeur vers un nouvel objet IVMVirtualMachine qui représente cette machine virtuelle.

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).

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

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