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 |
|---|---|
|
Operasi berhasil. Permintaan dikirim. Untuk informasi selengkapnya, lihat Keterangan. |
|
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 |