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 |
|
| IID |
IID_IVMGuestOS se define como 99fea0db-4880-499a-b6d8-73dff9bc91be |