Freigeben über

IScheduledWorkItem::GetExitCode-Methode (mstask.h)

  • Artikel

[[Diese API kann in nachfolgenden Versionen des Betriebssystems oder Produkts geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die Taskplaner 2.0-Schnittstellen .] ]

Ruft den letzten Exitcode ab, der von der ausführbaren Datei zurückgegeben wurde, die dem Arbeitselement bei der letzten Ausführung zugeordnet ist. Die -Methode gibt auch den Exitcode zurück, der beim letzten Versuch, das Arbeitselement auszuführen, an den Taskplaner zurückgegeben wurde.

Syntax

HRESULT GetExitCode(
  [out] DWORD *pdwExitCode
);

Parameter

[out] pdwExitCode

Ein Zeiger auf einen DWORD-Wert , der auf den letzten Exitcode für das Arbeitselement festgelegt ist. Dies ist der Exitcode, den das Arbeitselement zurückgegeben hat, als es zuletzt nicht mehr ausgeführt wurde. Wenn das Arbeitselement noch nie gestartet wurde, wird 0 zurückgegeben.

Rückgabewert

Die GetExitCode-Methode gibt den Fehler aus dem letzten Versuch zurück, das Arbeitselement zu starten. Die folgenden Werte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
 Der Versuch, das Arbeitselement zu starten, war erfolgreich.
SCHED_S_TASK_HAS_NOT_RUN
 Es wurde noch nie versucht, dieses Arbeitselement zu starten.
E_INVALIDARG
 Die Argumente sind ungültig.
E_OUTOFMEMORY
 Es ist nicht genügend Arbeitsspeicher verfügbar.

Hinweise

Diese Methode kann die folgenden zwei Informationen zurückgeben:

  • Der Fehler- oder Exitcode, der von der ausführbaren Datei zurückgegeben wird, die geplant wird, wird im pdwExitCode-Parameter zurückgegeben.
  • Der Fehlercode, den der Taskplaner beim Starten des Auftrags erhalten hat, wird im Aufruf der GetExitCode-Methode selbst zurückgegeben.
Um einen aktualisierten Fehlercode zu erhalten, rufen Sie zuerst immer ITaskScheduler::Activate auf, um eine neue IScheduledWorkItem-Schnittstelle zu erhalten, die dann zum Abrufen der aktualisierten Fehlercodes verwendet werden kann.

Beispiele

Ein Beispiel zum Abrufen des Erstellers einer Aufgabe finden Sie unter C/C++-Codebeispiel: Abrufen des Vorgangsausgangscodes.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mstask.h
Bibliothek Mstask.lib
DLL Mstask.dll
Verteilbare Komponente Internet Explorer 4.0 oder höher unter Windows NT 4.0 und Windows 95

Weitere Informationen

IScheduledWorkItem