Método SetPowerState da classe CIM_LogicalDevice (Provedores WMI CIMWin32)
O método SetPowerState da classe CIM_LogicalDevice define o estado de energia desejado para um dispositivo lógico e quando um dispositivo deve ser colocado nesse estado.
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.
-
Potência total (1)
-
Potência total.
-
Economia de energia – modo de energia baixa (2)
-
Power save low-power mode.
-
Power Save – Espera (3)
-
Economia de energia em espera.
-
Power Save - Outros (4)
-
Power save other.
-
Ciclo de Energia (5)
-
Ciclo de energia.
-
Desligar (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
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.
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 |
|