IVMGuestOS :: GetParameter, méthode

[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 un paramètre nommé dans le système d’exploitation invité.

Syntaxe

HRESULT GetParameter(
  [in]          BSTR inParameterName,
  [out, retval] BSTR *outParameterValue
);

Paramètres

inParameterName [ dans]

Nom du paramètre. Sa longueur doit être comprise entre 1 et 255 caractères et ne peut pas contenir de barre oblique inverse ( \ ).

outParameterValue [ out, retval]

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é.
E _ POINTEUR
0x80004003
Le paramètre a la valeur null.
Ordinateur virtuel _ E _ a _ expiré
0xA0040202
L’opération ne s’est pas terminée en temps opportun.
Ordinateur virtuel _ _Machine virtuelle _ non _ exécutée
0xA0040206
L’ordinateur virtuel n’est pas en cours d’exécution.
Ordinateur virtuel _ 0xA00400507 _ en _ pause de la machine virtuelle E
L’ordinateur virtuel est en pause.
Ordinateur virtuel _ La _ fonctionnalité d’ajouts E _ _ n’est pas disponible _
0xA0040505
Les composants d’intégration ne sont pas installés sur cet ordinateur virtuel.
DISP _ E _ exception
0x80020009
Une erreur inattendue s’est produite.

Remarques

L’ordinateur virtuel 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 basés sur Windows.

Avec 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 logiciel \ Microsoft \ Virtual \ machine \ paramètres invité

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

  • HostName
  • PhysicalHostName
  • PhysicalHostNameFullyQualified
  • VirtualMachineName

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 _ IVMGuestOS est défini en tant que 99fea0db-4880-499a-B6D8-73dff9bc91be

Voir aussi

IVMGuestOS