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
S _ OK
0
L'opération a réussi.
E _ POINTEUR
0x80004003
Le paramètre a la valeur null.
E _ INVALIDARG
0x80000003
Le paramètre n’est pas valide ou est une chaîne vide.
Ordinateur virtuel _ _Machine virtuelle _
0xA0040207
inconnue
La configuration est inconnue.
Ordinateur virtuel _ E/r 0xA0040302 _ _ _ active VM
L’ordinateur virtuel est en cours d’exécution ou enregistré.
Ordinateur virtuel _ E _ config _ sans _ nom
0xA0040400
Le paramètre virtualMachineName est vide.
Ordinateur virtuel _ Nom de la _ configuration E _ _ trop _ long
0xA00400401
Le paramètre contient trop de caractères.
Ordinateur virtuel _ Nom de la configuration E 0xA0040402 _ _ _ _ char non valide
Le paramètre contient l’un des caractères non valides suivants : « * ?: <>/ | \ ».
Ordinateur virtuel _ _ _ _ Nom en double de la configuration E
0xA0040403
Le nom spécifié existe déjà en tant que nom d’un autre ordinateur virtuel.
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. 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
VPCCOMInterfaces. h
IID
IID _ IVMVirtualMachine est défini en tant que f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Voir aussi

IVMVirtualMachine