Compartilhar via


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
CIMWin32.mof
DLL
CIMWin32.dll

Confira também

CIM_MediaAccessDevice

CIM_MediaAccessDevice