Classe Msvm_GuestServiceInterfaceComponent

Representa o estado do componente de interface de serviço convidado, que fornece um mecanismo para interagir com a máquina virtual a partir das interfaces de gerenciamento no sistema host. Essa classe deriva da classe CIM_LogicalDevice .

A sintaxe a seguir é simplificada do código MOF e inclui todas as propriedades herdadas.

Sintaxe

[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_GuestServiceInterfaceComponent : CIM_LogicalDevice
{
  uint16   Availability;
  string   Caption;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   Description;
  string   DeviceID;
  boolean  ErrorCleared;
  string   ErrorDescription;
  datetime InstallDate;
  uint32   LastErrorCode;
  string   Name;
  string   PNPDeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  PowerManagementSupported;
  string   Status;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
};

Membros

A classe Msvm_GuestServiceInterfaceComponent tem estes tipos de membros:

• Métodos
• Propriedades

Métodos

A classe Msvm_GuestServiceInterfaceComponent tem esses métodos.

Método	Descrição
RequestStateChange	Solicita que o estado do componente da interface de serviço convidado seja alterado para o valor especificado.
Redefinir	Solicita uma redefinição do dispositivo lógico. Não implementado pelo WMI.
SetPowerState	Define o estado de energia desejado para um dispositivo lógico e quando um dispositivo deve ser colocado nesse estado. Não implementado pelo WMI.

Propriedades

A classe Msvm_GuestServiceInterfaceComponent tem essas propriedades.

Disponibilidade

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Disponibilidade e status do dispositivo.

Valor	Significado
Outros 1 (0x1)
Desconhecido 2 (0x2)
Energia completa/em execução 3 (0x3)
Aviso 4 (0x4)
Em teste 5 (0x5)
Não aplicável 6 (0x6)
Desligar 7 (0x7)
Off Line 8 (0x8)
Desativada 9 (0x9)
Degradado 10 (0xA)
Não instalados 11 (0xB)
Erro de instalação 12 (0xC)
Economia de energia – Desconhecido 13 (0xD)	O dispositivo é conhecido por estar em um modo de economia de energia, mas seu status exato é desconhecido.
Economia de energia – modo de energia insuficiente 14 (0xE)	O dispositivo está em um estado de economia de energia, mas ainda funcionando e pode apresentar desempenho degradado.
Economia de energia – espera 15 (0xF)	O dispositivo não está funcionando, mas pode ser levado à energia total rapidamente.
Ciclo de Energia 16 (0x10)
Economia de energia – Aviso 17 (0x11)	O dispositivo está em um estado de aviso, embora também em um modo de economia de energia.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Descrição textual curta do objeto. Essa propriedade é herdada de CIM_ManagedSystemElement.

ConfigManagerErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Win32 Configuration Manager código de erro.

Valor	Significado
0 (0x0)	O dispositivo está funcionando corretamente.
1 (0x1)	O dispositivo não está configurado corretamente.
2 (0x2)	O Windows não pode carregar o driver para este dispositivo.
3 (0x3)	O driver para este dispositivo pode estar corrompido ou o sistema pode estar com pouca memória ou outros recursos.
4 (0x4)	O dispositivo não está funcionando corretamente. Um de seus drivers ou o registro pode estar corrompido.
5 (0x5)	O driver para o dispositivo requer um recurso que o Windows não pode gerenciar.
6 (0x6)	A configuração de inicialização do dispositivo está em conflito com outros dispositivos.
7 (0x7)	Não é possível filtrar.
8 (0x8)	O carregador de driver para o dispositivo está ausente.
9 (0x9)	O dispositivo não está funcionando corretamente; o firmware de controle está relatando incorretamente os recursos para o dispositivo.
10 (0xA)	O dispositivo não pode ser iniciado.
11 (0xB)	Falha no dispositivo.
12 (0xC)	O dispositivo não pode encontrar recursos gratuitos suficientes para usar.
13 (0xD)	O Windows não pode verificar os recursos do dispositivo.
14 (0xE)	O dispositivo não pode funcionar corretamente até que o computador seja reiniciado.
15 (0xF)	O dispositivo não está funcionando corretamente devido a um possível problema de renumeração.
16 (0x10)	O Windows não pode identificar todos os recursos que o dispositivo usa.
17 (0x11)	O dispositivo está solicitando um tipo de recurso desconhecido.
18 (0x12)	Os drivers de dispositivo devem ser reinstalados.
19 (0x13)	Falha ao usar o carregador VxD.
20 (0x14)	O Registro pode estar corrompido.
21 (0x15)	Falha do sistema. Se a alteração do driver de dispositivo for ineficaz, consulte a documentação de hardware. O Windows está removendo o dispositivo.
22 (0x16)	O dispositivo está desabilitado.
23 (0x17)	Falha do sistema. Se a alteração do driver de dispositivo for ineficaz, consulte a documentação de hardware.
24 (0x18)	O dispositivo não está presente, não está funcionando corretamente ou não tem todos os seus drivers instalados.
25 (0x19)	O Windows ainda está configurando o dispositivo.
26 (0x1A)	O Windows ainda está configurando o dispositivo.
27 (0x1B)	O dispositivo não tem uma configuração de log válida.
28 (0x1C)	Os drivers de dispositivo não estão instalados.
29 (0x1D)	O dispositivo está desabilitado; o firmware do dispositivo não forneceu os recursos necessários.
30 (0x1E)	O dispositivo está usando um recurso IRQ que outro dispositivo está usando.
31 (0x1F)	O dispositivo não está funcionando corretamente; O Windows não pode carregar os drivers de dispositivo necessários.

ConfigManagerUserConfig

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se TRUE, o dispositivo está usando uma configuração definida pelo usuário.

CreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Nome da classe ou subclasse usada na criação de uma instância. Quando usada com outras propriedades de chave da classe , essa propriedade permite que todas as instâncias da classe e suas subclasses sejam identificadas exclusivamente.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Descrição textual do objeto. Essa propriedade é herdada de CIM_ManagedSystemElement.

Deviceid

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Endereço ou outras informações de identificação para nomear exclusivamente o dispositivo lógico.

ErrorCleared

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se TRUE, o erro relatado na propriedade LastErrorCode agora será limpo.

ErrorDescription

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Cadeia de caracteres de forma livre que fornece informações sobre o erro registrado na propriedade LastErrorCode e ações corretivas a serem executadas.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Data e hora em que o objeto foi instalado. Essa propriedade não precisa de um valor para indicar que o objeto está instalado. Essa propriedade é herdada de CIM_ManagedSystemElement.

LastErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Último código de erro relatado pelo dispositivo lógico.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Rótulo pelo qual o objeto é conhecido. Quando subclasse, essa propriedade pode ser substituída para ser uma propriedade de chave. Essa propriedade é herdada de CIM_ManagedSystemElement.

PNPDeviceID

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Indica o win32 Plug and Play identificador de dispositivo do dispositivo lógico.

Exemplo: "*PNP030b"

PowerManagementCapabilities

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Matriz dos recursos específicos relacionados à energia de um dispositivo lógico. Essa propriedade é herdada de CIM_LogicalDevice.

Valor	Significado
Desconhecido 0 (0x0)
Sem suporte 1 (0x1)
Desabilitado 2 (0x2)
Enabled 3 (0x3)	Os recursos de gerenciamento de energia estão habilitados no momento, mas o conjunto exato de recursos é desconhecido ou as informações não estão disponíveis.
Modos de economia de energia inseridos automaticamente 4 (0x4)	O dispositivo pode alterar seu estado de energia com base no uso ou em outros critérios.
Power State Settable 5 (0x5)	Há suporte para o método SetPowerState . Esse método é encontrado na classe de CIM_LogicalDevice pai e pode ser implementado. Para obter mais informações, consulte Criando classes MOF (Managed Object Format).
Power Cycling com suporte 6 (0x6)	O método SetPowerState pode ser invocado com o parâmetro PowerState definido como 5 ("Power Cycle").
Ativação cronometrada com suporte 7 (0x7)	O método SetPowerState pode ser invocado com o parâmetro PowerStatedefinido como 5 ("Power Cycle") e Time definido como uma data e hora específicas, ou intervalo, para ativação.

PowerManagementSupported

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Se TRUE, o dispositivo poderá ser gerenciado por energia, ou seja, colocado em um estado de economia de energia. Se FALSE, o valor inteiro 1 ("Sem Suporte") deverá ser a única entrada na matriz PowerManagementCapabilities .

Essa propriedade não indica se os recursos de gerenciamento de energia estão habilitados no momento ou se estão habilitados, quais recursos têm suporte. Para obter mais informações, consulte a matriz PowerManagementCapabilities .

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Status atual do objeto. Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

"OK"

"Erro"

"Degradado"

"Desconhecido"

"Pred Fail"

"Iniciando"

"Parando"

"Serviço"

"Estressado"

"NonRecover"

"Sem Contato"

"Lost Comm"

StatusInfo

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Estado do dispositivo lógico. Se essa propriedade não se aplicar ao dispositivo lógico, o valor 5 ("Não Aplicável") deverá ser usado. Essa propriedade é herdada de CIM_LogicalDevice.

Outro (1 (0x1))

Desconhecido (2 (0x2))

Habilitado (3 (0x3))

Desabilitado (4 (0x4))

Não aplicável (5 (0x5))

SystemCreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Nome da classe de criação do sistema de escopo.

Systemname

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Nome do sistema de escopo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8.1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 R2 [somente aplicativos da área de trabalho]
Namespace	Root\Virtualization\V2
MOF	WindowsVirtualization.V2.mof
DLL	Vmms.exe

Confira também

CIM_LogicalDevice

CIM_LogicalDevice