Compartilhar via


Classe CIM_Battery

A classe CIM_Battery representa os recursos e o gerenciamento do dispositivo lógico da bateria. Essa classe se aplica a baterias em sistemas portáteis e outras baterias internas e externas.

Importante

As classes CIM (Modelo de Informações Comuns) do DMTF (Distributed Management Task Force) são as classes pai nas quais as classes WMI são criadas. Atualmente, o WMI dá suporte apenas aos esquemas de versão CIM 2.x.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. As propriedades são listadas em ordem alfabética, não em ordem MOF.

Sintaxe

[Abstract, UUID("{8502C548-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class CIM_Battery : CIM_LogicalDevice
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Name;
  string   Status;
  uint16   Availability;
  uint32   ConfigManagerErrorCode;
  boolean  ConfigManagerUserConfig;
  string   CreationClassName;
  string   DeviceID;
  uint16   PowerManagementCapabilities[];
  boolean  ErrorCleared;
  string   ErrorDescription;
  uint32   LastErrorCode;
  string   PNPDeviceID;
  boolean  PowerManagementSupported;
  uint16   StatusInfo;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   BatteryStatus;
  uint16   Chemistry;
  uint32   DesignCapacity;
  uint64   DesignVoltage;
  uint16   EstimatedChargeRemaining;
  uint32   EstimatedRunTime;
  uint32   ExpectedLife;
  uint32   FullChargeCapacity;
  uint32   MaxRechargeTime;
  string   SmartBatteryVersion;
  uint32   TimeOnBattery;
  uint32   TimeToFullCharge;
};

Membros

A classe CIM_Battery tem estes tipos de membros:

Métodos

A classe CIM_Battery tem esses métodos.

Método Descrição
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 o dispositivo deve ser colocado nesse estado. Não implementado pelo WMI.

Propriedades

A classe CIM_Battery tem essas propriedades.

Disponibilidade

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Estado operacional|003.5", "MIB. IETF| HOST-RESOURCES-MIB.hrDeviceStatus")

Disponibilidade e status do dispositivo.

Essa propriedade é herdada de CIM_LogicalDevice.

Outros (1)

Desconhecido (2)

Energia completa/em execução (3)

Aviso (4)

Em Teste (5)

Não aplicável (6)

Desligar (7)

Off Line (8)

Desativada (9)

Degradado (10)

Não Instalado (11)

Erro de instalação (12)

Economia de energia – Desconhecido (13)

O dispositivo é conhecido por estar em um modo de economia de energia, mas seu status exato é desconhecido.

Economia de energia – modo de energia baixa (14)

O dispositivo está em um estado de economia de energia, mas ainda funcionando e pode apresentar desempenho degradado.

Economia de energia – espera (15)

O dispositivo não está funcionando, mas pode ser levado à energia total rapidamente.

Ciclo de Energia (16)

Economia de energia – Aviso (17)

O dispositivo está em um estado de aviso, embora também em um modo de economia de energia.

Pausado (18)

O dispositivo está em pausa.

Não Pronto (19)

O dispositivo não está pronto.

Não Configurado (20)

O dispositivo não está configurado.

Quiesced (21)

O dispositivo está silencioso.

BatteryStatus

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria portátil|002.14")

Descrição da carga da bateria status. O valor 10 não é válido no esquema CIM, que representa nenhuma bateria sendo instalada na DMI (Interface de Gerenciamento de Área de Trabalho). Nesse caso, o objeto não deve ser instanciado.

Outros (1)

Outros.

Desconhecido (2)

Desconhecida.

Totalmente cobrado (3)

Totalmente cobrado.

Baixo (4)

Baixa:

Crítico (5)

Crítica.

Carregamento (6)

Carregamento.

Carregamento e Alta (7)

Carregamento e alta.

Carregamento e baixo (8)

Carregamento e baixo.

Carregamento e crítico (9)

Carregamento e crítico.

Indefinido (10)

Indefinido.

Parcialmente cobrado (11)

Parcialmente cobrado.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64), DisplayName ("Caption")

Uma breve descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Química

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria portátil|002.7")

Enumeração que descreve a química da bateria.

Outros (1)

Outros.

Desconhecido (2)

Desconhecida.

Ácido de chumbo (3)

Ácido de chumbo.

Níquel Cadmium (4)

Níquel cádmio.

Hydride metal de níquel (5)

Hidreto metálico de níquel.

Íon-lítio (6)

Íon de lítio.

Ar de zinco (7)

Ar de zinco.

Polímero de lítio (8)

Polímero de lítio.

ConfigManagerErrorCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

Win32 Configuration Manager código de erro.

Essa propriedade é herdada de CIM_LogicalDevice.

Este dispositivo está funcionando corretamente. acima (0)

Este dispositivo não está configurado corretamente. (1)

O Windows não pode carregar o driver para este dispositivo. (2)

O driver deste dispositivo pode estar corrompido ou o sistema pode estar com pouca memória ou outros recursos. (3)

Este dispositivo não está funcionando corretamente. Um de seus drivers ou seu registro pode estar corrompido. (4)

O driver deste dispositivo precisa de um recurso que o Windows não possa gerenciar. (5)

A configuração de inicialização deste dispositivo está em conflito com outros dispositivos. (6)

Não é possível filtrar. (7)

O carregador de driver para o dispositivo está ausente. (8)

Este dispositivo não está funcionando corretamente porque o firmware de controle está relatando os recursos para o dispositivo incorretamente. (9)

Este dispositivo não pode ser iniciado. (10)

Este dispositivo falhou. (11)

Este dispositivo não pode encontrar recursos gratuitos suficientes que ele pode usar. (12)

O Windows não pode verificar os recursos deste dispositivo. (13)

Este dispositivo não pode funcionar corretamente até que você reinicie o computador. (14)

Este dispositivo não está funcionando corretamente porque provavelmente há um problema de renumeração. (15)

O Windows não pode identificar todos os recursos que este dispositivo usa. (16)

Este dispositivo está solicitando um tipo de recurso desconhecido. (17)

Reinstale os drivers para este dispositivo. (18)

Falha ao usar o carregador VxD. (19)

Seu registro pode estar corrompido. (20)

Falha do sistema: tente alterar o driver deste dispositivo. Se isso não funcionar, consulte a documentação de hardware. O Windows está removendo este dispositivo. (21)

Este dispositivo está desabilitado. (22)

Falha do sistema: tente alterar o driver deste dispositivo. Se isso não funcionar, consulte a documentação de hardware. (23)

Este dispositivo não está presente, não está funcionando corretamente ou não tem todos os drivers instalados. (24)

O Windows ainda está configurando este dispositivo. (25)

O Windows ainda está configurando este dispositivo. (26)

Este dispositivo não tem uma configuração de log válida. (27)

Os drivers para este dispositivo não estão instalados. (28)

Esse dispositivo está desabilitado porque o firmware do dispositivo não lhe deu os recursos necessários. (29)

Este dispositivo está usando um recurso irq (solicitação de interrupção) que outro dispositivo está usando. (30)

Este dispositivo não está funcionando corretamente porque o Windows não pode carregar os drivers necessários para este dispositivo. (31)

ConfigManagerUserConfig

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: Esquema ("Win32")

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

Essa propriedade é herdada de CIM_LogicalDevice.

CreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: CIM_Key

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.

Essa propriedade é herdada de CIM_LogicalDevice.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Description")

Uma descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

DesignCapacity

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria Portátil|002.8"), Unidades ("miliwatt-horas")

Capacidade projetada da bateria em miliwatts-hora. Se essa propriedade não tiver suporte, insira 0.

DesignVoltage

Tipo de dados: uint64

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria Portátil|002.9"), Unidades ("milisvoltas")

Tensão projetada da bateria em milisvoltas. Se esse atributo não tiver suporte, insira 0.

Para obter mais informações sobre como usar valores uint64 em scripts, consulte Scripts no WMI.

Deviceid

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: CIM_Key

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

Essa propriedade é herdada de CIM_LogicalDevice.

ErrorCleared

Tipo de dados: booliano

Tipo de acesso: Somente leitura

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

Essa propriedade é herdada de CIM_LogicalDevice.

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.

Essa propriedade é herdada de CIM_LogicalDevice.

EstimatedChargeRemaining

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: Unidades ("porcentagem")

Percentual estimado do encargo total restante.

EstimatedRunTime

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria Portátil|002.15"), Unidades ("minutos")

Tempo estimado, em minutos, até que a carga da bateria seja esgotada sob as condições de carga atuais se a energia do utilitário estiver desligada, seja perdida e permaneça desativada ou se um laptop for desconectado de uma fonte de energia.

ExpectedLife

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: Unidades ("minutos")

Tempo de vida esperado da bateria, em minutos, supondo que a bateria esteja totalmente carregada. Essa propriedade representa a vida útil total esperada da bateria, não sua vida útil restante atual, que é indicada pela propriedade EstimatedRunTime .

FullChargeCapacity

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria Portátil|002.11"), Unidades ("miliwatts-hora")

A capacidade de carga total da bateria em miliwatts-hora. Compare esse valor com a propriedade DesignCapacity para determinar quando a bateria requer substituição. A duração final de uma bateria normalmente é quando a propriedade FullChargeCapacity fica abaixo de 80% da propriedade DesignCapacity . Se essa propriedade não tiver suporte, insira 0.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não 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.

Essa propriedade é herdada de CIM_LogicalDevice.

MaxRechargeTime

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: Unidades ("minutos")

Tempo máximo, em minutos, para carregar totalmente a bateria. Essa propriedade representa o tempo para recarregar uma bateria totalmente esgotada, não o tempo de carregamento restante atual, que é indicado na propriedade TimeToFullCharge .

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Name")

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

Qualificadores: Esquema ("Win32")

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

Exemplo: "*PNP030b"

Essa propriedade é herdada de CIM_LogicalDevice.

PowerManagementCapabilities

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Indica os recursos específicos relacionados à energia do dispositivo lógico.

Essa propriedade é herdada de CIM_LogicalDevice.

Desconhecido (0)

As capacidades relacionadas à energia são desconhecidas.

Sem suporte (1)

Não há suporte para capacidades relacionadas à energia para este dispositivo.

Desabilitado (2)

As capacidades relacionadas à energia foram desabilitadas.

Habilitado (3)

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)

O dispositivo pode alterar seu estado de energia com base no uso ou em outros critérios.

Power State Settable (5)

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)

O método SetPowerState pode ser invocado com o parâmetro PowerState definido como 5 ("Power Cycle").

Com suporte para ativação cronometrada (7)

O método SetPowerState pode ser invocado com o parâmetro PowerState definido como 5 ("Power Cycle") e o parâmetro 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 .

Essa propriedade é herdada de CIM_LogicalDevice.

SmartBatteryVersion

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64), MappingStrings ("MIF. DMTF| Bateria portátil|002.10")

Número de versão de especificação de dados de bateria inteligente compatível com essa bateria. Se a bateria não der suporte a essa função, o valor deverá ser deixado vazio.

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (10), DisplayName ("Status")

Cadeia de caracteres que indica o status atual do objeto. As status operacionais e não operacionais podem ser definidas. As status operacionais podem incluir "OK", "Degradado" e "Falha de Pred". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).

As status não operacionais podem incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante o disco espelho-resilvering, recarregando uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Pred Fail ("Pred Fail")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem Contato ("Sem Contato")

Lost Comm ("Lost Comm")

StatusInfo

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Estado operacional|003.3")

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.

Outros (1)

Desconhecido (2)

Habilitado (3)

Desabilitado (4)

Não aplicável (5)

SystemCreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: propagados ("CIM_System. CreationClassName"), CIM_Key

O nome da classe de criação do sistema de escopo.

Essa propriedade é herdada de CIM_LogicalDevice.

Systemname

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: propagados ("CIM_System. Nome"), CIM_Key

O nome do sistema de escopo.

Essa propriedade é herdada de CIM_LogicalDevice.

TimeOnBattery

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: unidades ("segundos")

Tempo decorrido, em segundos, desde a última vez que o UPS do sistema do computador mudou para a energia da bateria, ou a quantidade de tempo desde que o sistema ou UPS foi reiniciado pela última vez, o que for menor. Um valor de 0 será retornado se a bateria estiver "online".

TimeToFullCharge

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| Bateria Portátil|002.16"), Unidades ("minutos")

Tempo restante, em minutos, para carregar totalmente a bateria na taxa de carregamento atual e usar.

Comentários

A classe CIM_Battery é derivada de CIM_LogicalDevice.

O WMI não implementa essa classe. Para obter mais informações sobre classes derivadas de CIM_Battery, consulte Classes Win32.

Esta documentação é derivada das descrições da classe CIM publicadas pelo DMTF. A Microsoft pode ter feito alterações para corrigir erros secundários, estar em conformidade com os padrões de documentação do SDK da Microsoft ou fornecer mais informações.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

Confira também

CIM_LogicalDevice