Interfaccia IVMGuestOS

[Windows Virtual PC non è più disponibile per l'uso a partire da Windows 8. Usare invece il provider WMI Hyper-V (V2).]

Definisce il sistema operativo guest in esecuzione all'interno di una macchina virtuale. Questa interfaccia consente di interagire con i componenti di integrazione in esecuzione all'interno del sistema operativo guest. È possibile recuperare IVMGuestOS per una macchina virtuale usando la proprietà IVMVirtualMachine::GuestOS .

Membri

L'interfaccia IVMGuestOS eredita dall'interfaccia IDispatch . IVMGuestOS include anche questi tipi di membri:

Metodi

L'interfaccia IVMGuestOS include questi metodi.

Metodo Descrizione
GetOsVersionInfo Recupera le informazioni sulla versione per il sistema operativo guest in esecuzione nella macchina virtuale.
GetParameter Recupera un parametro denominato all'interno del guest.
InstallIntegrationComponents Individua e installa i componenti di integrazione più recenti nel sistema operativo guest.
IsUserLoggedOn Determina se la sessione richiesta è presente.
Disconnessione Disconnette tutti gli utenti dal sistema operativo guest.
Riavvia Riavvia il sistema operativo guest.
SetParameter Imposta un parametro denominato all'interno del guest.
Arresto Arresta il sistema operativo guest.

Proprietà

L'interfaccia IVMGuestOS ha queste proprietà.

Proprietà Tipo di accesso Descrizione
CanShutdown
Sola lettura
Indica se il sistema operativo guest può essere arrestato in modo pulito (richiede Componenti di integrazione).
Nomecomputer
Sola lettura
Nome computer del sistema operativo guest in esecuzione nella macchina virtuale.
CSDVersion
Sola lettura
CsDVersion del sistema operativo guest in esecuzione nella macchina virtuale.
HeartbeatPercentage
Sola lettura
Percentuale di heartbeat previsti ricevuti negli ultimi minuti.
IntegrationComponentsVersion
Sola lettura
Versione dei componenti di integrazione installata nel sistema operativo guest.
IsHeartbeating
Sola lettura
Indica se la macchina virtuale ha un heartbeat.
IsHostTimeSyncEnabled
Lettura/Scrittura
Indica se i componenti di integrazione in questa macchina virtuale devono sincronizzare l'orologio del guest con l'orologio dell'host.
MultipleUserSessionsAllowed
Sola lettura
Indica se sono consentite più sessioni utente simultanee nel sistema operativo guest.
OSBuildNumber
Sola lettura
Numero di compilazione del sistema operativo guest in esecuzione nella macchina virtuale.
OSMajorVersion
Sola lettura
Versione principale del sistema operativo guest in esecuzione nella macchina virtuale.
OSMinorVersion
Sola lettura
Versione secondaria del sistema operativo guest in esecuzione nella macchina virtuale.
OSName
Sola lettura
Nome del sistema operativo guest in esecuzione nella macchina virtuale.
OSPlatformId
Sola lettura
Identificatore della piattaforma del sistema operativo guest in esecuzione nella macchina virtuale.
OSVersion
Sola lettura
Versione del sistema operativo guest in esecuzione nella macchina virtuale.
ProductType
Sola lettura
Tipo di prodotto del sistema operativo guest in esecuzione nella macchina virtuale.
ScreenLocked
Sola lettura
Indica se la schermata è bloccata nel sistema operativo guest.
ServicePackMajor
Sola lettura
Versione principale del service pack del sistema operativo guest in esecuzione nella macchina virtuale.
ServicePackMinor
Sola lettura
Versione secondaria del service pack del sistema operativo guest in esecuzione nella macchina virtuale.
SuiteMask
Sola lettura
SuiteMask del sistema operativo guest in esecuzione nella macchina virtuale.
TerminalServerPort
Sola lettura
Porta usata dai servizi Desktop remoto nel sistema operativo guest.
TerminalServicesInitialized
Sola lettura
Stato dell'inizializzazione dei servizi terminal nel sistema operativo guest.

Requisiti

Requisito Valore
Client minimo supportato
Windows 7 [solo app desktop]
Server minimo supportato
Nessuno supportato
Fine del supporto client
Windows 7
Prodotto
Windows Virtual PC
Intestazione
VPCCOMInterfaces.h
IID
IID_IVMGuestOS è definito come 99fea0db-4880-499a-b6d8-73dff9bc91be