IVMVirtualPC :: RegisterVirtualMachine, méthode

[Windows Virtual PC ne peut plus être utilisé à partir de Windows 8. Au lieu de cela, utilisez le fournisseur WMI Hyper-V (v2).]

Inscrit une configuration d’ordinateur virtuel existante et récupère l’objet ordinateur virtuel.

Syntaxe

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

Paramètres

ConfigurationName [ dans]

Nom de la machine virtuelle à inscrire. 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 ne peut pas dépasser le _ chemin d’accès maximal (260) caractères. Le nom spécifié peut contenir l’extension. vmc. Si ce paramètre a la valeur null ou est une chaîne vide, le paramètre ConfigurationPath doit spécifier le chemin d’accès complet au fichier de configuration.

ConfigurationPath [ dans]

Chemin d’accès au dossier qui contient le fichier de configuration existant. Si le paramètre ConfigurationName a la valeur null ou est une chaîne vide, il doit spécifier le chemin d’accès complet au fichier de configuration existant.

VirtualMachine [ out, retval]

Pointeur vers un nouvel objet IVMVirtualMachine qui représente cet ordinateur virtuel.

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 _ POINTEUR
0x80004003
Le paramètre ConfigurationName ou ConfigurationPath n’est pas valide, ou VirtualMachine a la valeur null.
Valeur
HRESULT _ À partir de _ Win32 ( _ chemin d’erreur _ _ introuvable)
0x80070003
Le système ne trouve pas le chemin d’accès spécifié par les paramètres ConfigurationName et ConfigurationPath .
Valeur
HRESULT _ FROM _ Win32 ( _ fichier d' _ erreur _ introuvable)
0x80070002
Le système ne peut pas trouver le fichier spécifié par les paramètres ConfigurationName et ConfigurationPath .
Valeur
HRESULT _ À partir de _ Win32 (erreur _ _ nom non valide)
0x8007007b
Le paramètre ConfigurationPath contient un caractère non valide (l’un des « * ?: <>/ | »).
Valeur
HRESULT _ FROM _ Win32 (erreur _ de _ nom de chemin incorrect)
0x800700a1
Le paramètre ConfigurationPath spécifie un chemin d’accès vide ou relatif. Un chemin d’accès absolu est requis.
Valeur
HRESULT _ À partir de _ Win32 _ ( _ dépassement de mémoire tampon d’erreur)
0x8007006f
Le chemin d’accès spécifié par les paramètres ConfigurationName et ConfigurationPath génère un chemin d’accès trop long. La longueur combinée du chemin d’accès doit être inférieure à la longueur maximale _ (260) caractères.
Valeur
HRESULT _ À partir de _ Win32 (l’erreur _ _ existe déjà)
0x800700b7
Un fichier de configuration portant ce nom existe déjà à cet emplacement.
Ordinateur virtuel _ Nom de la _ configuration E _ _ trop _ long
0xA0040401
La longueur du paramètre ConfigurationName dépasse 80 caractères.
Ordinateur virtuel _ Nom de la configuration E 0xA0040402 _ _ _ _ char non valide
Le paramètre ConfigurationName contient un caractère non valide (l’un des « * ?: <>/ | \ »).
Ordinateur virtuel _ _ _ _ Nom en double de la configuration E
0xA0040403
Il existe déjà un ordinateur virtuel portant ce nom.
Ordinateur virtuel _ _Virtualisation matérielle E _ _ désactivée
0xA0040951
Le processeur ne prend pas en charge les extensions avez (Hardware Accelerated Virtualization).
DISP _ E _ exception
0x80020009
Une erreur inattendue s’est produite.

Remarques

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge
applications de [ bureau Windows 7 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 en tant que 236ba0d9-a24a-4292-A132-27c1421dfd01

Voir aussi

IVMVirtualPC