Metode IScheduledWorkItem::GetRunTimes (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 durasi item kerja untuk periode waktu tertentu.
Sintaks
HRESULT GetRunTimes(
[in] const LPSYSTEMTIME pstBegin,
[in] const LPSYSTEMTIME pstEnd,
[in, out] WORD *pCount,
[out] LPSYSTEMTIME *rgstTaskTimes
);
Parameter
[in] pstBegin
Penunjuk ke struktur SYSTEMTIME yang berisi waktu mulai periode waktu untuk diperiksa. Nilai ini inklusif.
[in] pstEnd
Penunjuk ke struktur SYSTEMTIME yang berisi waktu akhir periode waktu untuk diperiksa. Nilai ini eksklusif. Jika NULL diteruskan untuk nilai ini, waktu akhir tidak terbatas.
[in, out] pCount
Penunjuk ke nilai WORD yang menentukan jumlah durasi yang akan diambil.
Pada input, parameter ini berisi jumlah durasi yang diminta. Ini bisa berupa sejumlah antara 1 dan TASK_MAX_RUN_TIMES.
Pada output, parameter ini berisi jumlah durasi yang diambil.
[out] rgstTaskTimes
Penunjuk ke array struktur SYSTEMTIME . Objek NULL LPSYSTEMTIME harus diteruskan ke parameter ini. Saat dikembalikan, array ini berisi waktu jalankan pCount . Anda harus membebaskan array ini dengan memanggil fungsi CoTaskMemFree .
Nilai kembali
Metode GetRunTimes mengembalikan salah satu nilai berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Jumlah durasi yang diminta diambil. |
|
Metode berhasil, tetapi kurang dari jumlah durasi yang diminta diambil. Jumlah waktu eksekusi yang diambil terkandung dalam nilai yang diacu oleh pCount. Jika jumlah durasi yang diambil adalah nol, juga tidak ada pemicu berbasis peristiwa yang dapat menyebabkan item kerja dijalankan selama periode waktu yang ditentukan. |
|
Item kerja diaktifkan tetapi tidak memiliki pemicu yang valid. |
|
Item kerja dinonaktifkan. |
|
Satu atau beberapa argumen tidak valid. |
|
Memori tidak cukup untuk menghitung hasilnya. |
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 |