Condividi tramite

Metodo IScheduledWorkItem::GetExitCode (mstask.h)

  • Articolo

[[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 l'ultimo codice di uscita restituito dall'eseguibile associato all'elemento di lavoro nell'ultima esecuzione. Il metodo restituisce anche il codice di uscita restituito all'utilità di pianificazione quando ha tentato di eseguire l'elemento di lavoro.

Sintassi

HRESULT GetExitCode(
  [out] DWORD *pdwExitCode
);

Parametri

[out] pdwExitCode

Puntatore a un valore DWORD impostato sull'ultimo codice di uscita per l'elemento di lavoro. Si tratta del codice di uscita restituito dall'elemento di lavoro quando è stato arrestato l'ultima esecuzione. Se l'elemento di lavoro non è mai stato avviato, viene restituito 0.

Valore restituito

Il metodo GetExitCode restituisce l'errore dall'ultimo tentativo di avviare l'elemento di lavoro. Di seguito sono indicati alcuni valori possibili.

Codice restituito Descrizione
S_OK
 Il tentativo di avviare l'elemento di lavoro ha avuto esito positivo.
SCHED_S_TASK_HAS_NOT_RUN
 Non è mai stato effettuato alcun tentativo di avviare questo elemento di lavoro.
E_INVALIDARG
 Gli argomenti non sono validi.
E_OUTOFMEMORY
 Memoria insufficiente.

Commenti

Questo metodo può restituire le due informazioni seguenti:

  • L'errore o il codice di uscita restituito dall'eseguibile pianificato viene restituito nel parametro pdwExitCode .
  • Il codice di errore ricevuto dall'utilità di pianificazione quando ha tentato di avviare il processo viene restituito nel metodo GetExitCode .
Per ottenere un codice di errore aggiornato, chiamare sempre ITaskScheduler::Activate per ottenere prima una nuova interfaccia IScheduledWorkItem , che può quindi essere usata per ottenere i codici di errore aggiornati.

Esempio

Per un esempio di come recuperare l'autore di un'attività, vedere Esempio di codice C/C++: Recupero del codice di uscita dell'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

Vedi anche

IScheduledWorkItem