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 |
|---|---|
|
L'opération a réussi. |
|
Un paramètre n’est pas valide ou n’est pas spécifié. |
|
Le paramètre a la valeur null. |
|
L’opération ne s’est pas terminée en temps opportun. |
|
L’ordinateur virtuel n’est pas en cours d’exécution. |
|
L’ordinateur virtuel est en pause. |
|
Les composants d’intégration ne sont pas installés sur cet ordinateur virtuel. |
|
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 |
|
| IID |
IID _ IVMGuestOS est défini en tant que 99fea0db-4880-499a-B6D8-73dff9bc91be |