IVMVirtualPC::CreateVirtualMachine, méthode

Article
06/13/2023

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

Crée une configuration de machine virtuelle et récupère l’objet de machine virtuelle.

Syntaxe

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

Paramètres

configurationName [in]: Nom de la machine virtuelle à créer. La longueur du nom ne peut pas dépasser 80 caractères et la longueur combinée du nom et du chemin d’accès aux fichiers VMC et VMCX ne peut pas dépasser MAX_PATH (260) caractères. Les extensions de nom de fichier .vmc et .vmcx sont ajoutées à la fin du nom de la machine virtuelle lors de la création des fichiers de configuration. Si ce paramètre a la valeur NULL ou une chaîne vide, le paramètre configurationPath doit spécifier le chemin d’accès complet au fichier VMC.
configurationPath [in]: Chemin d’accès au dossier qui contiendra le fichier VMC. Ce dossier sera créé s’il n’existe pas. Si configurationName a la valeur NULL ou une chaîne vide, cela doit spécifier le chemin d’accès complet du nouveau fichier de configuration.
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.
E_POINTER 0x80004003	Le paramètre configurationName ou configurationPath n’est pas valide ou le paramètre virtualMachine a la valeur NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Le système ne trouve pas le chemin spécifié par le paramètre configurationPath .
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Le paramètre configurationPath contient un caractère non valide (l’un des « *?:<>/\| »).
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Le paramètre configurationPath spécifie un chemin d’accès vide ou relatif. Un chemin d’accès absolu est requis.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Le chemin d’accès spécifié par les paramètres configurationName et configurationPath entraîne un chemin d’accès trop long. La longueur totale du chemin doit être inférieure à MAX_PATH (260) caractères.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	Un fichier de configuration portant ce nom existe déjà à cet emplacement.
VM_E_CONFIG_NO_NAME 0xA0040400	Le paramètre configurationName est vide.
VM_E_CONFIG_NAME_TOO_LONG 0xA0040401	Le paramètre configurationName dépasse 80 caractères.
VM_E_CONFIG_NAME_INVALID_CHAR 0xA0040402	Le paramètre configurationName contient un caractère non valide (l’un des « *?:<>/\|\" »).
VM_E_CONFIG_DUPLICATE_NAME 0xA0040403	Il existe déjà une machine virtuelle portant ce nom.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Le processeur ne prend pas en charge les extensions HAV (Hardware Accelerated Virtualization).
DISP_E_EXCEPTION 0x80020009	Une erreur inattendue s’est produite.

Notes

Les noms des 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

Share via