Metodo SetPowerState della classe CIM_PointingDevice
Il metodo SetPowerState della classe CIM_PointingDevice imposta lo stato di alimentazione desiderato per un dispositivo logico e quando un 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.
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
-
Risparmio energia bassa modalità.
-
3
-
Risparmio energia standby.
-
4
-
Risparmio energia.
-
5
-
Ciclo di alimentazione.
-
6
-
Disattiva.
Ora [in]
Specifica 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 ("Power Cycle"), 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 |
|