Partilhar via

Propriedade IVMGuestOS::OSName

  • Artigo

[O Pc 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).]

Recupera o nome do sistema operacional convidado em execução na VM (máquina virtual).

Esta propriedade é somente para leitura.

Syntax

HRESULT get_OSName(
  [out, retval] BSTR *guestOSName
);

Valor da propriedade

O nome completo (incluindo o nome do pacote) do sistema operacional convidado.

Códigos de erro

Nome/valor Significado
S_OK
0
 A operação foi bem-sucedida.
E_POINTER
0x80004003
 O parâmetro é NULL.
VM_E_VM_NOT_RUNNING
0xA0040206
 A VM não está em execução.
VM_E_ADDITIONS_FEATURE_NOT_AVAIL
0xA0040505
 Os componentes de integração não estão instalados nesta VM.
DISP_E_EXCEPTION
0x80020009
 Ocorreu um erro inesperado.

Comentários

A VM deve estar em execução (ou seja, totalmente inicializada e não está sendo fechada) e os componentes de integração devem ser instalados quando esse método é invocado.

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

Confira também

IVMGuestOS