Interfaz IVMGuestOS

[Windows Virtual PC ya no está disponible para su uso a partir de Windows 8. En su lugar, use el proveedor WMI de Hyper-V (V2)].

Define el sistema operativo invitado que se ejecuta dentro de una máquina virtual. Esta interfaz permite interactuar con los componentes de integración que se ejecutan dentro del sistema operativo invitado. IVMGuestOS para una máquina virtual se puede recuperar mediante la propiedad IVMVirtualMachine::GuestOS.

Miembros

La interfaz IVMGuestOS hereda de la interfaz IDispatch . IVMGuestOS también tiene estos tipos de miembros:

• Métodos
• Propiedades

Métodos

La interfaz IVMGuestOS tiene estos métodos.

Método	Descripción
GetOsVersionInfo	Recupera la información de versión del sistema operativo invitado que se ejecuta en la máquina virtual.
GetParameter	Recupera un parámetro con nombre dentro del invitado.
InstallIntegrationComponents	Busca e instala los componentes de integración más recientes en el sistema operativo invitado.
IsUserLoggedOn	Determina si la sesión solicitada está presente.
Cerrar sesión	Cierra la sesión de todos los usuarios del sistema operativo invitado.
Reiniciar	Reinicia el sistema operativo invitado.
SetParameter	Establece un parámetro con nombre dentro del invitado.
Apagado	Apaga el sistema operativo invitado.

Propiedades

La interfaz IVMGuestOS tiene estas propiedades.

Propiedad	Tipo de acceso	Descripción
CanShutdown	Solo lectura	Indica si el sistema operativo invitado se puede apagar limpiamente (requiere componentes de integración).
ComputerName	Solo lectura	Nombre del equipo del sistema operativo invitado que se ejecuta en la máquina virtual.
CSDVersion	Solo lectura	CSDVersion del sistema operativo invitado que se ejecuta en la máquina virtual.
HeartbeatPercentage	Solo lectura	Porcentaje de latidos esperados recibidos en el último minuto.
IntegrationComponentsVersion	Solo lectura	La versión de los componentes de integración instalados en el sistema operativo invitado.
IsHeartbeating	Solo lectura	Indica si la máquina virtual tiene un latido.
IsHostTimeSyncEnabled	Lectura/escritura	Indica si los componentes de integración de esta máquina virtual deben sincronizar el reloj del invitado con el reloj del host.
MultipleUserSessionsAllowed	Solo lectura	Indica si se permiten varias sesiones de usuario simultáneas en el sistema operativo invitado.
OSBuildNumber	Solo lectura	Número de compilación del sistema operativo invitado que se ejecuta en la máquina virtual.
OSMajorVersion	Solo lectura	La versión principal del sistema operativo invitado que se ejecuta en la máquina virtual.
OSMinorVersion	Solo lectura	La versión secundaria del sistema operativo invitado que se ejecuta en la máquina virtual.
OSName	Solo lectura	Nombre del sistema operativo invitado que se ejecuta en la máquina virtual.
OSPlatformId	Solo lectura	Identificador de plataforma del sistema operativo invitado que se ejecuta en la máquina virtual.
OSVersion	Solo lectura	Versión del sistema operativo invitado que se ejecuta en la máquina virtual.
ProductType	Solo lectura	Tipo de producto del sistema operativo invitado que se ejecuta en la máquina virtual.
ScreenLocked	Solo lectura	Indica si la pantalla está bloqueada en el sistema operativo invitado.
ServicePackMajor	Solo lectura	La versión principal del Service Pack del sistema operativo invitado que se ejecuta en la máquina virtual.
ServicePackMinor	Solo lectura	La versión secundaria del Service Pack del sistema operativo invitado que se ejecuta en la máquina virtual.
SuiteMask	Solo lectura	SuiteMask del sistema operativo invitado que se ejecuta en la máquina virtual.
TerminalServerPort	Solo lectura	Puerto usado por Servicios de Escritorio remoto en el sistema operativo invitado.
TerminalServicesInitialized	Solo lectura	Estado de inicialización de Terminal Services en el sistema operativo invitado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Fin de compatibilidad de cliente	Windows 7
Producto	Windows Virtual PC
Encabezado	VPCCOMInterfaces.h
IID	IID_IVMGuestOS se define como 99fea0db-4880-499a-b6d8-73dff9bc91be