Bagikan melalui

Metode IScheduledWorkItem::GetRunTimes (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 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
S_OK
 Jumlah durasi yang diminta diambil.
S_FALSE
 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.
SCHED_S_TASK_NO_VALID_TRIGGERS
 Item kerja diaktifkan tetapi tidak memiliki pemicu yang valid.
SCHED_S_TASK_DISABLED
 Item kerja dinonaktifkan.
E_INVALIDARG
 Satu atau beberapa argumen tidak valid.
E_OUTOFMEMORY
 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

Lihat juga

IScheduledWorkItem