Método SetPowerState da classe CIM_MediaAccessDevice
O método SetPowerState da classe CIM_MediaAccessDevice 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]
-
Um valor ValueMap que especifica o estado de energia desejado para este dispositivo lógico.
-
1
-
Energia total.
-
2
-
Economia de energia no modo de baixa energia.
-
3
-
Economia de energia em espera.
-
4
-
Economia de energia para outros.
-
5
-
Ciclo de energia.
-
6
-
Desligar.
Hora [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 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 |
|