Método SetPowerState da classe CIM_AggregatePExtent
O método SetPowerState define o estado de energia desejado para um dispositivo lógico e quando o 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.
Para obter mais informações sobre como usar esse método com C/C++, consulte Chamando um método.
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]
-
O valor ValueMap que especifica o estado de energia desejado para este dispositivo lógico.
-
1
-
Energia total
-
2
-
Modo de baixa energia de economia de energia
-
3
-
Power-save em espera
-
4
-
Salvar outras energias
-
5
-
Ciclo de energia
-
6
-
Desligar
Tempo [in]
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 (ciclo de energia), 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 |
|
| DLL |
|