Compartilhar via


Método SetPowerState da classe CIM_CoolingDevice

O método SetPowerState define o estado de energia desejado para um dispositivo lógico e quando um dispositivo deve ser colocado nesse estado. Em uma subclasse, o conjunto de possíveis códigos de retorno deve ser especificado usando um qualificador ValueMap no método . As cadeias de caracteres para as quais o conteúdo ValueMap é traduzido também devem ser especificadas na subclasse como um qualificador de matriz De valores . Esse método é herdado de CIM_LogicalDevice.

Importante

As classes CIM do DMTF (Distributed Management Task Force) (Common Information Model) 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.

Sintaxe

uint32 SetPowerState(
  [in] uint16   PowerState,
  [in] datetime Time
);

Parâmetros

PowerState [in]

Um valor ValueMap que especifica o estado de energia desejado para este dispositivo lógico.

1

Potência total.

2

Power save low-power mode.

3

Economia de energia em espera.

4

Power save other.

5

Ciclo de energia.

6

Desligar.

Tempo [in]

Especifica quando o estado de energia deve ser definido, como um valor de data e hora regular ou como um valor de intervalo (em que o intervalo começa quando a invocação do método é recebida). Quando o parâmetro PowerState é igual a 5 ("Power Cycle"), o parâmetro Time indica quando o dispositivo deve ligar novamente. A desligar é imediata.

Valor retornado

Retornará 0 (zero) se tiver êxito, 1 (um) se não houver suporte para a solicitaçãode Tempo e PowerState especificada e outro valor se ocorrer outro erro.

Comentários

Atualmente, esse método não é implementado pelo WMI. Para usar esse método, você deve implementá-lo em seu próprio provedor.

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_CoolingDevice

CIM_CoolingDevice