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 .
A interface IVMGuestOS herda da interface IDispatch . IVMGuestOS também tem esses tipos de membros:
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. |
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. |
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 |
|
IID |
IID_IVMGuestOS é definido como 99fea0db-4880-499a-b6d8-73dff9bc91be |