Interface IVMGuestOS
[Windows Virtual PC n’est plus disponible à partir de Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]
Définit le système d’exploitation invité s’exécutant à l’intérieur d’une machine virtuelle. Cette interface vous permet d’interagir avec les composants d’intégration qui s’exécutent à l’intérieur du système d’exploitation invité. L’OBJET IVMGuestOS d’une machine virtuelle peut être récupéré à l’aide de la propriété IVMVirtualMachine::GuestOS.
L’interface IVMGuestOS hérite de l’interface IDispatch. IVMGuestOS a également les types de membres suivants :
L’interface IVMGuestOS a ces méthodes.
Méthode | Description |
---|---|
GetOsVersionInfo | Récupère les informations de version du système d’exploitation invité s’exécutant sur la machine virtuelle. |
Getparameter | Récupère un paramètre nommé au sein de l’invité. |
InstallIntegrationComponents | Recherche et installe les composants d’intégration les plus récents dans le système d’exploitation invité. |
IsUserLoggedOn | Détermine si la session demandée est présente. |
Déconnexion | Déconnecte tous les utilisateurs du système d’exploitation invité. |
Redémarrer | Redémarre le système d’exploitation invité. |
SetParameter | Définit un paramètre nommé dans l’invité. |
Arrêt | Arrête le système d’exploitation invité. |
L’interface IVMGuestOS a ces propriétés.
Propriété | Type d’accès | Description |
---|---|---|
CanShutdown |
Lecture seule |
Indique si le système d’exploitation invité peut être correctement arrêté (nécessite des composants d’intégration). |
ComputerName |
Lecture seule |
Nom de l’ordinateur du système d’exploitation invité en cours d’exécution dans la machine virtuelle. |
CSDVersion |
Lecture seule |
CSDVersion du système d’exploitation invité s’exécutant dans 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ée 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 cette machine virtuelle 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 dans la machine virtuelle. |
OSMajorVersion |
Lecture seule |
Version majeure du système d’exploitation invité s’exécutant sur la machine virtuelle. |
OSMinorVersion |
Lecture seule |
Version mineure du système d’exploitation invité s’exécutant sur la machine virtuelle. |
OSName |
Lecture seule |
Nom du système d’exploitation invité en cours d’exécution dans la machine virtuelle. |
OSPlatformId |
Lecture seule |
Identificateur de plateforme du système d’exploitation invité en cours d’exécution dans la machine virtuelle. |
OSVersion |
Lecture seule |
Version du système d’exploitation invité s’exécutant sur la machine virtuelle. |
ProductType |
Lecture seule |
Type de produit du système d’exploitation invité en cours d’exécution dans 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é s’exécutant sur la machine virtuelle. |
ServicePackMinor |
Lecture seule |
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 les services Bureau à distance dans le système d’exploitation invité. |
TerminalServicesInitialized |
Lecture seule |
Status de l’initialisation des services Terminal Server dans le système d’exploitation invité. |
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 |
|
IID |
IID_IVMGuestOS est défini comme 99fea0db-4880-499a-b6d8-73dff9bc91be |