Metodo SetPowerState della classe CIM_AggregatePExtent
Il metodo SetPowerState imposta lo stato di alimentazione desiderato per un dispositivo logico e quando il dispositivo deve essere inserito in tale stato. In una sottoclasse è necessario specificare il set di codici restituiti possibili usando un qualificatore ValueMap nel metodo . Le stringhe a cui deve essere convertito il contenuto di ValueMap devono essere specificate anche nella sottoclasse come qualificatore matrice Valori . Questo metodo viene ereditato da CIM_LogicalDevice.
Per altre informazioni sull'uso di questo metodo con C/C++, vedere Chiamata di un metodo.
Importante
Le classi CIM (Distributed Management Task Force) (Common Information Model) di DMTF (Distributed Management Task Force) sono le classi padre su cui vengono compilate le classi WMI. WMI supporta attualmente solo gli schemi di versione CIM 2.x.
Sintassi
uint32 SetPowerState(
[in] uint16 PowerState,
[in] datetime Time
);
Parametri
-
PowerState [in]
-
Valore ValueMap che specifica lo stato di alimentazione desiderato per questo dispositivo logico.
-
1
-
Potenza completa
-
2
-
Modalità risparmio energia bassa
-
3
-
Standby di risparmio energia
-
4
-
Risparmio energia altre
-
5
-
Ciclo di alimentazione
-
6
-
Spegnimento
Ora [in]
Quando lo stato di alimentazione deve essere impostato, come valore di data-ora regolare o come valore di intervallo (dove l'intervallo inizia quando viene ricevuta la chiamata al metodo). Quando il parametro PowerState è uguale a 5 (ciclo di alimentazione), il parametro Time indica quando il dispositivo deve essere attivato di nuovo. L'alimentazione è immediata.
Valore restituito
Restituisce 0 (zero) se ha esito positivo, 1 (uno) se la richiesta PowerState e Time specificata non è supportata e un altro valore se si è verificato un altro errore.
Commenti
Questo metodo non è attualmente implementato da WMI. Per usare questo metodo, è necessario implementarlo nel proprio provider.
Questa documentazione deriva dalle descrizioni della classe CIM pubblicate dal DMTF. Microsoft potrebbe aver apportato modifiche agli errori secondari corretti, conformi agli standard della documentazione di Microsoft SDK o fornire altre informazioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Spazio dei nomi |
Radice\CIMV2 |
| MOF |
|
| DLL |
|