IVMVirtualMachine :: Name, propriété
[Windows Virtual PC ne peut plus être utilisé à partir de Windows 8. Au lieu de cela, utilisez le fournisseur WMI Hyper-V (v2).]
Récupère et définit le nom de la configuration de l’ordinateur virtuel.
Cette propriété est en lecture/écriture.
Syntaxe
HRESULT put_Name(
[in] BSTR virtualMachineName
);
HRESULT get_Name(
[out, retval] BSTR *virtualMachineName
);
Valeur de la propriété
Spécifie le nom de la configuration de l’ordinateur virtuel. La longueur du nom ne peut pas dépasser 80 caractères et la longueur totale du chemin d’accès complet qui comprend le fichier de configuration du nom de l’ordinateur virtuel ne peut pas dépasser le _ chemin d’accès maximal (260) caractères.
Codes d’erreur
| Nom/valeur | Signification |
|---|---|
|
L'opération a réussi. |
|
Le paramètre a la valeur null. |
|
Le paramètre n’est pas valide ou est une chaîne vide. |
|
La configuration est inconnue. |
|
L’ordinateur virtuel est en cours d’exécution ou enregistré. |
|
Le paramètre virtualMachineName est vide. |
|
Le paramètre contient trop de caractères. |
|
Le paramètre contient l’un des caractères non valides suivants : « * ?: <>/ | \ ». |
|
Le nom spécifié existe déjà en tant que nom d’un autre ordinateur virtuel. |
|
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. Il s’agit de la propriété par défaut pour IVMVirtualMachine.
Si VPC.exe est en cours d’exécution et que la machine virtuelle est enregistrée, la définition de la propriété Name échouera. Si VPC.exe n’est pas en cours d’exécution et que la machine virtuelle est enregistrée, la définition de la propriété Name est réussie lors du prochain démarrage de VPC.exe.
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 _ IVMVirtualMachine est défini en tant que f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |