Bagikan melalui


Metode IScheduledWorkItem::GetStatus (mstask.h)

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

Mengambil status item kerja.

Sintaks

HRESULT GetStatus(
  [out] HRESULT *phrStatus
);

Parameter

[out] phrStatus

Penunjuk ke nilai HRESULT yang berisi salah satu nilai berikut saat dikembalikan.

SCHED_S_TASK_READY

Item kerja siap dijalankan pada waktu terjadwal berikutnya.

SCHED_S_TASK_RUNNING

Item kerja saat ini sedang berjalan.

SCHED_S_TASK_NOT_SCHEDULED

Satu atau beberapa properti yang diperlukan untuk menjalankan tugas ini pada jadwal belum ditetapkan.

SCHED_S_TASK_HAS_NOT_RUN

Tugas belum dijalankan. Nilai ini dikembalikan setiap kali tugas belum dijalankan, bahkan jika tugas siap dijalankan pada waktu terjadwal berikutnya atau tugas tersebut adalah tugas berulang.

SCHED_S_TASK_DISABLED

Tugas tidak akan berjalan pada waktu yang dijadwalkan karena telah dinonaktifkan.

SCHED_S_TASK_NO_MORE_RUNS

Tidak ada lagi eksekusi yang dijadwalkan untuk tugas ini.

SCHED_S_TASK_NO_VALID_TRIGGERS

Baik tugas tidak memiliki pemicu atau pemicu yang ada dinonaktifkan atau tidak diatur.

Nilai kembali

Metode GetStatus mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
S_OK
Operasi berhasil. Permintaan dikirim. Untuk informasi selengkapnya, lihat Keterangan.
E_INVALIDARG
Argumen tidak valid.

Keterangan

Metode antarmuka IScheduledWorkItem diwarisi oleh antarmuka ITask . Akibatnya, IScheduledWorkItem::GetStatus biasanya dipanggil melalui antarmuka ITask .

IScheduledWorkItem::GetStatus tidak mendapatkan status tugas secara dinamis. ITaskScheduler::Activate harus dipanggil untuk mendapatkan antarmuka IScheduledWorkItem baru, yang digunakan untuk mendapatkan status yang diperbarui. Untuk informasi selengkapnya, lihat contoh untuk ITaskScheduler::Activate.

Contoh

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

Untuk contoh cara mengambil status tugas sebagai bagian dari mengakhiri tugas, lihat Mengakhiri Contoh 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

ITask