Método SetPowerState da classe CIM_AggregatePSExtent
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 (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.
Sintaxe
uint32 SetPowerState(
[in] uint16 PowerState,
[in] datetime Time
);
Parâmetros
-
PowerState [in]
-
O valor ValueMap que especifica o estado de energia desejado para esse dispositivo lógico.
-
1
-
Energia total
-
2
-
Modo de economia de energia baixa
-
3
-
Espera de economia de energia
-
4
-
Salvar outras energias
-
5
-
Ciclo de energia
-
6
-
Desligar
Hora [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 energia é imediata.
Valor retornado
Retornará 0 (zero) se tiver êxito, 1 (um) se a solicitaçãode Tempo e o PowerState especificados não tiverem suporte e outro valor se ocorrer qualquer 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 |
|