Interface IVMGuestOS
[Windows Virtual PC ne peut plus être utilisé à partir de Windows 8. Au lieu de cela, utilisez le fournisseur WMI Hyper-V (v2).]
Définit le système d’exploitation invité en cours d’exécution au sein d’une machine virtuelle. Cette interface vous permet d’interagir avec les composants d’intégration qui s’exécutent dans le système d’exploitation invité. Le IVMGuestOS d’un ordinateur virtuel peut être récupéré à l’aide de la propriété IVMVirtualMachine :: guestos .
Membres
L’interface IVMGuestOS hérite de l’interface IDispatch . IVMGuestOS a également les types de membres suivants :
Méthodes
L’interface IVMGuestOS possède ces méthodes.
| Méthode | Description |
|---|---|
| GetOsVersionInfo | Récupère des informations de version pour le système d’exploitation invité en cours d’exécution sur l’ordinateur virtuel. |
| GetParameter | Récupère un paramètre nommé au sein de l’invité. |
| InstallIntegrationComponents | Localise et installe les derniers composants d’intégration dans le système d’exploitation invité. |
| IsUserLoggedOn | Détermine si la session demandée est présente. |
| Fermeture | Déconnecte tous les utilisateurs du système d’exploitation invité. |
| Faire | Redémarre le système d’exploitation invité. |
| SetParameter | Définit un paramètre nommé au sein de l’invité. |
| Correct | Arrête le système d’exploitation invité. |
Propriétés
L’interface IVMGuestOS possède les propriétés suivantes.
| Propriété | Type d’accès | Description |
|---|---|---|
| CanShutdown |
Lecture seule |
Indique si le système d’exploitation invité peut être arrêté proprement (nécessite des composants d’intégration). |
| ComputerName |
Lecture seule |
Nom d’ordinateur du système d’exploitation invité en cours d’exécution sur l’ordinateur virtuel. |
| CSDVersion |
Lecture seule |
CSDVersion du système d’exploitation invité en cours d’exécution sur la machine virtuelle. |
| HeartbeatPercentage |
Lecture seule |
Pourcentage de pulsations attendues reçues au cours de la dernière minute. |
| IntegrationComponentsVersion |
Lecture seule |
Version des composants d’intégration installés dans le système d’exploitation invité. |
| IsHeartbeating |
Lecture seule |
Indique si la machine virtuelle a une pulsation. |
| IsHostTimeSyncEnabled |
Lecture/écriture |
Indique si les composants d’intégration de cet ordinateur virtuel doivent synchroniser l’horloge de l’invité avec l’horloge de l’hôte. |
| MultipleUserSessionsAllowed |
Lecture seule |
Indique si plusieurs sessions utilisateur simultanées sont autorisées dans le système d’exploitation invité. |
| OSBuildNumber |
Lecture seule |
Numéro de build du système d’exploitation invité en cours d’exécution sur la machine virtuelle. |
| OSMajorVersion |
Lecture seule |
Version principale du système d’exploitation invité en cours d’exécution sur la machine virtuelle. |
| OSMinorVersion |
Lecture seule |
Version mineure du système d’exploitation invité en cours d’exécution sur l’ordinateur virtuel. |
| OSName |
Lecture seule |
Nom du système d’exploitation invité en cours d’exécution sur la machine virtuelle. |
| OSPlatformId |
Lecture seule |
Identificateur de plateforme du système d’exploitation invité en cours d’exécution sur l’ordinateur virtuel. |
| OSVersion |
Lecture seule |
Version du système d’exploitation invité en cours d’exécution sur la machine virtuelle. |
| ProductType |
Lecture seule |
Type de produit du système d’exploitation invité en cours d’exécution sur la machine virtuelle. |
| ScreenLocked |
Lecture seule |
Indique si l’écran est verrouillé dans le système d’exploitation invité. |
| ServicePackMajor |
Lecture seule |
Version principale du Service Pack du système d’exploitation invité en cours d’exécution sur la machine virtuelle. |
| ServicePackMinor |
Lecture seule |
La version mineure du Service Pack du système d’exploitation invité s’exécutant sur la machine virtuelle. |
| SuiteMask |
Lecture seule |
SuiteMask du système d’exploitation invité en cours d’exécution sur la machine virtuelle. |
| TerminalServerPort |
Lecture seule |
Port utilisé par Services Bureau à distance dans le système d’exploitation invité. |
| TerminalServicesInitialized |
Lecture seule |
État de l’initialisation des services Terminal Server dans le système d’exploitation invité. |
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 |