Interface IVMGuestOS

[O Computador Virtual do Windows não está mais disponível para uso a partir de Windows 8. Em vez disso, use o provedor WMI do Hyper-V (V2).]

Define o sistema operacional convidado em execução dentro de uma máquina virtual. Essa interface permite que você interaja com os componentes de integração em execução dentro do sistema operacional convidado. O IVMGuestOS para uma máquina virtual pode ser recuperado usando a propriedade IVMVirtualMachine::GuestOS .

Membros

A interface IVMGuestOS herda da interface IDispatch . IVMGuestOS também tem esses tipos de membros:

Métodos

A interface IVMGuestOS tem esses métodos.

Método Descrição
GetOsVersionInfo Recupera informações de versão para o sistema operacional convidado em execução na máquina virtual.
Getparameter Recupera um parâmetro nomeado dentro do convidado.
InstallIntegrationComponents Localiza e instala os componentes de integração mais recentes no sistema operacional convidado.
IsUserLoggedOn Determina se a sessão solicitada está presente.
Logoff Faz logoff de todos os usuários do sistema operacional convidado.
Reiniciar Reinicia o sistema operacional convidado.
Setparameter Define um parâmetro nomeado dentro do convidado.
Desligamento Desliga o sistema operacional convidado.

Propriedades

A interface IVMGuestOS tem essas propriedades.

Propriedade Tipo de acesso Descrição
Canshutdown
Somente leitura
Indica se o sistema operacional convidado pode ser desligado de forma limpa (requer componentes de integração).
ComputerName
Somente leitura
O nome do computador do sistema operacional convidado em execução na máquina virtual.
CSDVersion
Somente leitura
O CSDVersion do sistema operacional convidado em execução na máquina virtual.
HeartbeatPercentage
Somente leitura
A porcentagem de pulsações esperadas recebidas no último minuto.
IntegrationComponentsVersion
Somente leitura
A versão dos Componentes de Integração instalados no sistema operacional convidado.
IsHeartbeating
Somente leitura
Indica se a máquina virtual tem uma pulsação.
IsHostTimeSyncEnabled
Leitura/gravação
Indica se os Componentes de Integração nesta máquina virtual devem sincronizar o relógio do convidado com o relógio do host.
MultipleUserSessionsAllowed
Somente leitura
Indica se várias sessões simultâneas de usuário são permitidas no sistema operacional convidado.
OSBuildNumber
Somente leitura
O número de build do sistema operacional convidado em execução na máquina virtual.
OSMajorVersion
Somente leitura
A versão principal do sistema operacional convidado em execução na máquina virtual.
OSMinorVersion
Somente leitura
A versão secundária do sistema operacional convidado em execução na máquina virtual.
OSName
Somente leitura
O nome do sistema operacional convidado em execução na máquina virtual.
OSPlatformId
Somente leitura
O identificador de plataforma do sistema operacional convidado em execução na máquina virtual.
OSVersion
Somente leitura
A versão do sistema operacional convidado em execução na máquina virtual.
ProductType
Somente leitura
O tipo de produto do sistema operacional convidado em execução na máquina virtual.
ScreenLocked
Somente leitura
Indica se a tela está bloqueada no sistema operacional convidado.
ServicePackMajor
Somente leitura
A versão principal do service pack do sistema operacional convidado em execução na máquina virtual.
ServicePackMinor
Somente leitura
A versão secundária do service pack do sistema operacional convidado em execução na máquina virtual.
SuiteMask
Somente leitura
O SuiteMask do sistema operacional convidado em execução na máquina virtual.
TerminalServerPort
Somente leitura
Porta usada pelos Serviços de Área de Trabalho Remota no sistema operacional convidado.
TerminalServicesInitialized
Somente leitura
O status da inicialização dos Serviços de Terminal no sistema operacional convidado.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Nenhum compatível
Fim do suporte ao cliente
Windows 7
Produto
Windows Virtual PC
Cabeçalho
VPCCOMInterfaces.h
IID
IID_IVMGuestOS é definido como 99fea0db-4880-499a-b6d8-73dff9bc91be