Metode ITaskService::GetRunningTasks (taskschd.h)

Artikel
07/16/2024

Mendapatkan kumpulan tugas yang sedang berjalan.

NoteITaskService::GetRunningTasks hanya akan mengembalikan kumpulan tugas yang sedang berjalan pada atau di bawah konteks keamanan pengguna. Misalnya, untuk anggota grup Administrator, GetRunningTasks akan mengembalikan kumpulan semua tugas yang sedang berjalan, tetapi untuk anggota grup Pengguna, GetRunningTasks hanya akan mengembalikan kumpulan tugas yang berjalan di bawah konteks keamanan grup Pengguna.

Sintaksis

HRESULT GetRunningTasks(
  [in]  LONG                   flags,
  [out] IRunningTaskCollection **ppRunningTasks
);

Parameter

[in] flags

Nilai dari enumerasi TASK_ENUM_FLAGS. Teruskan 0 untuk mengembalikan kumpulan tugas yang sedang berjalan yang bukan tugas tersembunyi.

[out] ppRunningTasks

Antarmuka IRunningTaskCollection yang berisi tugas yang sedang berjalan.

Berikan referensi ke NULLIRunningTaskCollection penunjuk antarmuka. Mereferensikan pointer NULL non-dapat menyebabkan kebocoran memori karena pointer akan ditimpa.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

	Deskripsi
E_INVALIDARG	Argumen yang tidak valid ditentukan dalam panggilan metode. Meneruskan nilai bukan nol ke bendera parameter akan mengembalikan E_INVALIDARG.
S_OK	Operasi berhasil diselesaikan.
E_POINTER	NULL diteruskan ke parameter retVal .
HRESULT_FROM_WIN32(ERROR_ONLY_IF_CONNECTED)	Pengguna belum tersambung ke layanan.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Platform Target	Windows
Header	taskschd.h
Pustaka	Taskschd.lib
DLL	Taskschd.dll

Lihat juga

IRunningTaskCollection

ITaskService

TASK_ENUM_FLAGS

Penjadwal Tugas

Bagikan melalui