Leer en inglés

Compartir a través de


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

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