PROPRIÉTÉ IVMVirtualMachine::Name
[Windows Virtual PC n’est plus disponible à partir de Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]
Récupère et définit le nom de la configuration de la machine virtuelle.
Cette propriété est en lecture/écriture.
HRESULT put_Name(
[in] BSTR virtualMachineName
);
HRESULT get_Name(
[out, retval] BSTR *virtualMachineName
);
Spécifie le nom de la configuration de la machine virtuelle. La longueur du nom ne peut pas dépasser 80 caractères et la longueur totale du chemin d’accès complet qui inclut le fichier de configuration de nom de machine virtuelle ne peut pas être supérieure à MAX_PATH (260) caractères.
Nom/valeur | Signification |
---|---|
|
L'opération a réussi. |
|
Le paramètre est NULL. |
|
Le paramètre n’est pas valide ou est une chaîne vide. |
|
La configuration est inconnue. |
|
La machine virtuelle est en cours d’exécution ou enregistrée. |
|
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’une autre machine virtuelle. |
|
Une erreur inattendue s’est produite. |
Les noms de machines virtuelles 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 n’aboutira pas. 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 réussit lors du prochain démarrage de VPC.exe.
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 |
|
IID |
IID_IVMVirtualMachine est défini comme f7092aa1-33ed-4f78-a59f-c00adfc2edd7 |