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 |
|---|---|
|
L'opération a réussi. |
|
Le paramètre ConfigurationName ou ConfigurationPath n’est pas valide, ou VirtualMachine a la valeur null. |
|
Le système ne trouve pas le chemin d’accès spécifié par les paramètres ConfigurationName et ConfigurationPath . |
|
Le système ne peut pas trouver le fichier spécifié par les paramètres ConfigurationName et ConfigurationPath . |
|
Le paramètre ConfigurationPath contient un caractère non valide (l’un des « * ?: <>/ | »). |
|
Le paramètre ConfigurationPath spécifie un chemin d’accès vide ou relatif. Un chemin d’accès absolu est requis. |
|
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. |
|
Un fichier de configuration portant ce nom existe déjà à cet emplacement. |
|
La longueur du paramètre ConfigurationName dépasse 80 caractères. |
|
Le paramètre ConfigurationName contient un caractère non valide (l’un des « * ?: <>/ | \ »). |
|
Il existe déjà un ordinateur virtuel portant ce nom. |
|
Le processeur ne prend pas en charge les extensions avez (Hardware Accelerated Virtualization). |
|
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 |
|
| IID |
IID _ IVMVirtualPC est défini en tant que 236ba0d9-a24a-4292-A132-27c1421dfd01 |