Partager via

IVMGuestOS::SetParameter, méthode

  • Article

[Windows Virtual PC n’est plus disponible depuis Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]

Définit un paramètre nommé dans le système d’exploitation invité.

Syntaxe

HRESULT SetParameter(
  [in] BSTR inParameterName,
  [in] BSTR inParameterValue
);

Paramètres

inParameterName [in]

Le nom du paramètre. Il doit comporter entre 1 et 255 caractères et ne peut pas contenir de barre oblique inverse (\).

inParameterValue [in]

Valeur du paramètre.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code/valeur de retour Description
S_OK
0
 L'opération a réussi.
E_INVALIDARG
0x80000003
 Un paramètre n’est pas valide ou n’est pas spécifié.
VM_E_TIMED_OUT
0xA0040202
 L’opération ne s’est pas terminée en temps opportun.
VM_E_VM_NOT_RUNNING
0xA0040206
 La machine virtuelle n’est pas en cours d’exécution.
VM_E_VM_PAUSED
0xA00400507
 La machine virtuelle est suspendue.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 Les composants d’intégration ne sont pas installés sur cette machine virtuelle.
DISP_E_EXCEPTION
0x80020009
 Une erreur inattendue s’est produite.

Notes

La machine virtuelle doit être en cours d’exécution et les composants d’intégration doivent être installés lorsque cette méthode est appelée. Cette méthode est uniquement prise en charge pour les systèmes d’exploitation invités Windows.

Une fois les composants d’intégration installés, la clé suivante est automatiquement ajoutée au registre du système d’exploitation invité :

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Virtual Machine\Guest\Parameters

Lorsque le système d’exploitation invité démarre, les valeurs de chaîne de Registre suivantes sont renseignées dans la clé Parameters :

  • HostName
  • PhysicalHostName
  • PhysicalHostNameFullyQualified
  • VirtualMachineName

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_IVMGuestOS est défini comme 99fea0db-4880-499a-b6d8-73dff9bc91be

Voir aussi

IVMGuestOS