Metodo IScheduledWorkItem::SetFlags (mstask.h)
[[Questa API può essere modificata o non disponibile nelle versioni successive del sistema operativo o del prodotto. Usare invece le interfacce dell'Utilità di pianificazione 2.0 . ]
Imposta i flag che modificano il comportamento di qualsiasi tipo di elemento di lavoro.
Sintassi
HRESULT SetFlags(
DWORD dwFlags
);
Parametri
dwFlags
Valore che specifica una combinazione di uno o più dei flag seguenti:
TASK_FLAG_INTERACTIVE
Questo flag viene usato durante la conversione dei processi del servizio Windows NT AT in elementi di lavoro. Il processo del servizio Windows NT AT fa riferimento a At.exe, l'utilità della riga di comando di Windows NT usata per la creazione di processi per il servizio pianificazione di Windows NT. Il servizio Utilità di pianificazione sostituisce il servizio Pianificazione ed è compatibile con le versioni precedenti. La conversione si verifica quando l'Utilità di pianificazione è installata in Windows NT/Windows 2000, ad esempio se si installa Internet Explorer 4.0 o si esegue l'aggiornamento a Windows 2000. Durante il processo di installazione, il codice di installazione dell'Utilità di pianificazione cerca i processi creati per il servizio AT e crea elementi di lavoro che eseguiranno la stessa operazione.
Per tali processi convertiti, il flag interattivo viene impostato se l'elemento di lavoro deve essere visualizzato all'utente. Quando questo flag non è impostato, non vengono visualizzati elementi di lavoro nella cartella Attività e non viene visualizzata alcuna interfaccia utente associata all'elemento di lavoro all'utente quando viene eseguito l'elemento di lavoro.
TASK_FLAG_DELETE_WHEN_DONE
L'elemento di lavoro verrà eliminato quando non sono presenti più tempi di esecuzione pianificati.
TASK_FLAG_DISABLED
L'elemento di lavoro è disabilitato. Ciò è utile per impedire temporaneamente l'esecuzione di un elemento di lavoro alle ore pianificate.
TASK_FLAG_HIDDEN
L'elemento di lavoro creato verrà nascosto.
TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
L'elemento di lavoro viene eseguito solo se l'utente specificato in IScheduledWorkItem::SetAccountInformation viene connesso in modo interattivo. Questo flag non ha alcun effetto sugli elementi di lavoro impostati per l'esecuzione nell'account locale.
TASK_FLAG_START_ONLY_IF_IDLE
L'elemento di lavoro inizia solo se il computer non è in uso all'ora di inizio pianificata.
TASK_FLAG_SYSTEM_REQUIRED
L'elemento di lavoro fa sì che il sistema venga ripreso o riattivato, se il sistema è in esecuzione sulla batteria. Questo flag è supportato solo nei sistemi che supportano timer di ripresa.
TASK_FLAG_KILL_ON_IDLE_END
L'elemento di lavoro termina se il computer esegue una transizione inattiva a non inattiva mentre l'elemento di lavoro è in esecuzione. Il computer non viene considerato inattiva fino al termine del tempo dei trigger IdleWait senza input dell'utente. Per informazioni sui trigger inattive, vedere Trigger inattiva.
TASK_FLAG_RESTART_ON_IDLE_RESUME
L'elemento di lavoro viene riavviato se il computer esegue una transizione non inattiva prima che tutto il task_triggers trascorso dell'elemento di lavoro. Usare questo flag in combinazione con TASK_FLAG_KILL_ON_IDLE_END.
TASK_FLAG_DONT_START_IF_ON_BATTERIES
L'elemento di lavoro non viene avviato se il computer di destinazione è in esecuzione sull'alimentazione a batteria.
TASK_FLAG_KILL_IF_GOING_ON_BATTERIES
L'elemento di lavoro termina e l'applicazione associata viene chiusa se il computer di destinazione dell'elemento di lavoro passa all'alimentazione a batteria.
TASK_FLAG_RUN_IF_CONNECTED_TO_INTERNET
L'elemento di lavoro viene eseguito solo se è attualmente presente una connessione Internet valida.
Valore restituito
Il metodo SetFlags restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
L'operazione è stata completata. |
|
Gli argomenti non sono validi. |
|
Memoria insufficiente. |
Commenti
I programmi devono chiamare il metodo IPersistFile::Save dopo aver chiamato SetFlags per aggiornare i flag.
Questo metodo viene usato per impostare i flag utilizzati da qualsiasi tipo di elemento di lavoro pianificato. Al contrario, ITask::SetTaskFlags viene usato solo per impostare i flag usati dalle attività pianificate.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | mstask.h |
| Libreria | Mstask.lib |
| DLL | Mstask.dll |
| Componente ridistribuibile | Internet Explorer 4.0 o versione successiva in Windows NT 4.0 e Windows 95 |