Share via

Metode IScheduledWorkItem::GetExitCode (mstask.h)

  • Artikel

[[API ini dapat diubah atau tidak tersedia dalam versi sistem operasi atau produk berikutnya. Silakan gunakan Antarmuka Penjadwal Tugas 2.0 sebagai gantinya.] ]

Mengambil kode keluar terakhir yang dikembalikan oleh executable yang terkait dengan item kerja pada eksekusi terakhirnya. Metode ini juga mengembalikan kode keluar yang dikembalikan ke Penjadwal Tugas ketika terakhir kali mencoba menjalankan item kerja.

Sintaks

HRESULT GetExitCode(
  [out] DWORD *pdwExitCode
);

Parameter

[out] pdwExitCode

Penunjuk ke nilai DWORD yang diatur ke kode keluar terakhir untuk item kerja. Ini adalah kode keluar yang dikembalikan item kerja ketika terakhir kali berhenti berjalan. Jika item kerja belum pernah dimulai, 0 dikembalikan.

Nilai kembali

Metode GetExitCode mengembalikan kesalahan dari upaya terakhir untuk memulai item kerja. Nilai yang mungkin termasuk yang berikut ini.

Menampilkan kode Deskripsi
S_OK
 Upaya untuk memulai item kerja berhasil.
SCHED_S_TASK_HAS_NOT_RUN
 Tidak ada upaya yang pernah dilakukan untuk memulai item kerja ini.
E_INVALIDARG
 Argumen tidak valid.
E_OUTOFMEMORY
 Memori tidak cukup tersedia.

Keterangan

Metode ini dapat mengembalikan dua informasi berikut:

  • Kesalahan atau kode keluar yang dikembalikan oleh executable yang sedang dijadwalkan dikembalikan dalam parameter pdwExitCode .
  • Kode kesalahan yang diterima Penjadwal Tugas ketika mencoba memulai pekerjaan dikembalikan dalam panggilan metode GetExitCode itu sendiri.
Untuk mendapatkan kode kesalahan yang diperbarui, selalu panggil ITaskScheduler::Activate terlebih dahulu untuk mendapatkan antarmuka IScheduledWorkItem baru, yang kemudian dapat digunakan untuk mendapatkan kode kesalahan yang diperbarui.

Contoh

Untuk contoh cara mengambil pembuat tugas, lihat Contoh Kode C/C++: Mengambil Kode Keluar Tugas.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header mstask.h
Pustaka Mstask.lib
DLL Mstask.dll
Redistribusi Internet Explorer 4.0 atau yang lebih baru pada Windows NT 4.0 dan Windows 95

Lihat juga

IScheduledWorkItem