IScheduledWorkItem::GetExitCode-Methode (mstask.h)

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