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
• Proprietà

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