Il metodo OnlineDevice è stato dichiarato obsoleto ed è sostituito dal metodo più generale RequestStateChange, il quale ha ...

Il metodo OnlineDevice è stato dichiarato obsoleto ed è sostituito dal metodo più generale RequestStateChange, il quale ha essenzialmente la stessa funzionalità messa a disposizione messa a disposizione da questo metodo.  Richiede che l'elemento LogicalDevice sia portato in linea (parametro di input di \"In linea\" = TRUE) o non in linea (= FALSE). \"In linea\" indica che l'elemento Device è pronto ad accettare richieste, è operativo e funzionante normalmente. In questo caso, la proprietà Availability dell'elemento Device sarebbe impostata sul valore 3 (\"In esecuzione/Consumo massimo\"). \"Non in linea\" indica che l'elemento Device è acceso ed operativo, ma che non risponde a richieste funzionali. In modalità non in linea, è possibile che un elemento Device sia in grado di eseguire operazioni di diagnostica o di generare avvisi operativi. Ad esempio, quando viene premuto il pulsante \"Offline\" (Non in linea) su una stampante, questo elemento Device non è più disponibile per l'elaborazione dei processi di stampa, ma può esserlo per diagnostica o per manutenzione.  Se il metodo completata l'operazione, le proprietà Availability e AdditionalAvailability dell'elemento Device dovranno riflettere lo stato aggiornato. Se si verifica un errore durante il tentativo di portare l'elemento Device in linea o non in linea, l'elemento dovrebbe rimanere nello stato in cui si trova. In altri termini, la richiesta, nel caso in cui non sia completata, non dovrebbe lasciare la Device in uno stato indeterminato. Quando la Device viene portata \"In linea\", dalla modalità \"Non in linea\", è opportuno, se possibile, ripristinarne l'ultimo stato \"In linea\". È possibile portare in linea o mettere non in linea solo una Device con valore \"Abilitato\" di EnabledState/StatusInfo e che sia stata configurata.  OnlineDevice restituisce il valore 0 se l'operazione è stata eseguita con successo, 1 se la richiesta non è supportata a causa dello stato corrente della Device e altri valori se si verificano errori diversi. In una sottoclasse, è possibile specificare il gruppo di possibili codici di ritorno, utilizzando un qualificatore ValueMap sul metodo. Nella sottoclasse è anche possibile specificare come qualificatore di matrice Values le stringhe in cui vengono 'convertiti' i contenuti di ValueMap.  La funzione di questo metodo si sovrappone a quella della proprietà RequestedState. RequestedState è stato aggiunto al modello per mantenere un record (un valore reso permanente) dell'ultima richiesta di stato. Chiamando il metodo OnlineDevice, la proprietà RequestedState dovrebbe impostarsi automaticamente in modo corretto.