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
• Propriétés

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