Lire en anglais

Partager via


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.

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 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.

Codes d’erreur

Nom/valeur Signification
S_OK
0
L'opération a réussi.
E_POINTER
0x80004003
Le paramètre est NULL.
E_INVALIDARG
0x80000003
Le paramètre n’est pas valide ou est une chaîne vide.
VM_E_VM_UNKNOWN
0xA0040207
La configuration est inconnue.
VM_E_PREF_VM_ACTIVE
0xA0040302
La machine virtuelle est en cours d’exécution ou enregistrée.
VM_E_CONFIG_NO_NAME
0xA0040400
Le paramètre virtualMachineName est vide.
VM_E_CONFIG_NAME_TOO_LONG
0xA00400401
Le paramètre contient trop de caractères.
VM_E_CONFIG_NAME_INVALID_CHAR
0xA0040402
Le paramètre contient l’un des caractères non valides suivants « *?:<>/|\ » ».
VM_E_CONFIG_DUPLICATE_NAME
0xA0040403
Le nom spécifié existe déjà en tant que nom d’une autre machine virtuelle.
DISP_E_EXCEPTION
0x80020009
Une erreur inattendue s’est produite.

Notes

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.

Spécifications

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
VPCCOMInterfaces.h
IID
IID_IVMVirtualMachine est défini comme f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Voir aussi

IVMVirtualMachine