Metodo OnlineDevice della classe CIM_LogicalPort
Il metodo OnlineDevice è stato deprecato al posto del metodo RequestStateChange più generale che si sovrappone direttamente alla funzionalità fornita da questo metodo.
Richiede che LogicalDevice venga portato online ("Online" parametro di input = TRUE) o portato offline (= FAL edizione Standard). "Online" indica che il dispositivo è pronto ad accettare le richieste ed è operativo e completamente funzionante. In questo caso, la proprietà Availability di Device\s verrà impostata su 3 ("Running/Full Power"). "Offline" indica che un dispositivo è acceso e operativo, ma non elabora le richieste funzionali. In uno stato offline, un dispositivo può essere in grado di eseguire la diagnostica o generare avvisi operativi. Ad esempio, quando il pulsante "Offline" viene premuto su una stampante, il dispositivo non è più disponibile per elaborare i processi di stampa, ma potrebbe essere disponibile per la diagnostica o la manutenzione.
Se questo metodo ha esito positivo, le proprietà Availability e AdditionalAvailability del dispositivo devono riflettere lo stato aggiornato. Se si verifica un errore durante il tentativo di portare il dispositivo online o offline, deve rimanere nello stato corrente. Internet Explorer, la richiesta, se non ha esito positivo, non deve lasciare il dispositivo in uno stato indeterminato. Quando si riporta un dispositivo di nuovo "Online", da una modalità "Offline", il dispositivo deve essere ripristinato all'ultimo stato "Online", se possibile. Solo un dispositivo con enabledState/StatusInfo "Abilitato" ed è stato configurato può essere portato online o portato offline.
OnlineDevice deve restituire 0 se ha esito positivo, 1 se la richiesta non è supportata affatto, 2 se la richiesta non è supportata a causa dello stato corrente del dispositivo e di un altro valore se si è verificato un altro errore. In una sottoclasse è possibile specificare il set di possibili codici restituiti usando un qualificatore ValueMap nel metodo . Le stringhe in cui il contenuto di ValueMap è \'translated\' possono essere specificate anche nella sottoclasse come qualificatore di matrice Values.
Si noti che la funzione di questo metodo si sovrappone alla proprietà RequestedState. RequestedState è stato aggiunto al modello per mantenere un record (ad esempio, un valore persistente) dell'ultima richiesta di stato. Richiamare il metodo OnlineDevice deve impostare la proprietà RequestedState in modo appropriato.
Sintassi
uint32 OnlineDevice(
[in] boolean Online
);
Parametri
-
Online [in]
-
Se TRUE, portare il dispositivo online, se FAL edizione Standard, portare il dispositivo OFFLINE.
Valore restituito
Da definire
Requisiti
| Client minimo supportato |
Windows 8 |
| Server minimo supportato |
Windows Server 2012 |
| Spazio dei nomi |
Root\standardcimv2 |
| MOF |
|
| DLL |
|