Metodo IScheduledWorkItem::GetExitCode (mstask.h)

Articolo
08/25/2023

[[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

Condividi tramite