Lire en anglais

Partager via


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.

Membres

L’interface IVMGuestOS hérite de l’interface IDispatch. IVMGuestOS a également les types de membres suivants :

Méthodes

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é.

Propriétés

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é.

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