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
VPCCOMInterfaces. h
IID
IID _ IVMGuestOS est défini en tant que 99fea0db-4880-499a-B6D8-73dff9bc91be