Metodo IScheduledWorkItem::GetStatus (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 . ]
Recupera lo stato dell'elemento di lavoro.
Sintassi
HRESULT GetStatus(
[out] HRESULT *phrStatus
);
Parametri
[out] phrStatus
Puntatore a un valore HRESULT che contiene uno dei valori seguenti al momento della restituzione.
SCHED_S_TASK_READY
L'elemento di lavoro è pronto per l'esecuzione al successivo orario pianificato.
SCHED_S_TASK_RUNNING
L'elemento di lavoro è attualmente in esecuzione.
SCHED_S_TASK_NOT_SCHEDULED
Una o più proprietà necessarie per eseguire questa attività in base a una pianificazione non sono state impostate.
SCHED_S_TASK_HAS_NOT_RUN
L'attività non è stata eseguita. Questo valore viene restituito ogni volta che l'attività non è stata eseguita, anche se l'attività è pronta per essere eseguita al successivo orario pianificato o l'attività è un'attività ricorrente.
SCHED_S_TASK_DISABLED
L'attività non verrà eseguita negli orari pianificati perché è stata disabilitata.
SCHED_S_TASK_NO_MORE_RUNS
Non sono previste altre esecuzioni pianificate per questa attività.
SCHED_S_TASK_NO_VALID_TRIGGERS
L'attività non ha trigger o i trigger esistenti sono disabilitati o non sono impostati.
Valore restituito
Il metodo GetStatus restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
L'operazione è stata completata. La richiesta è stata inviata. Per altre informazioni, vedere la sezione Osservazioni. |
|
Gli argomenti non sono validi. |
Commenti
I metodi dell'interfaccia IScheduledWorkItem vengono ereditati dall'interfaccia ITask . Di conseguenza, IScheduledWorkItem::GetStatus viene in genere chiamato tramite l'interfaccia ITask .
IScheduledWorkItem::GetStatus non ottiene lo stato dell'attività in modo dinamico. ITaskScheduler::Activate deve essere chiamato per ottenere una nuova interfaccia IScheduledWorkItem , usata per ottenere uno stato aggiornato. Per altre informazioni, vedere l'esempio per ITaskScheduler::Activate.
Esempio
Per un esempio di come recuperare lo stato di un'attività, vedere Esempio di codice C/C++: Recupero dello stato dell'attività.
Per un esempio di come recuperare lo stato dell'attività come parte dell'interruzione dell'attività, vedere Terminazione di un esempio di attività.
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 |