Metode IRegisteredTask::GetInstances (taskschd.h)

Artikel
07/16/2024

Mengembalikan semua instans tugas terdaftar yang sedang berjalan.

NoteIRegisteredTask::GetInstances hanya akan mengembalikan instans tugas terdaftar yang sedang berjalan pada atau di bawah konteks keamanan pengguna. Misalnya, untuk anggota grup Administrator, GetInstances akan mengembalikan semua instans tugas terdaftar yang sedang berjalan, tetapi untuk anggota grup Pengguna, GetInstances hanya akan mengembalikan instans tugas terdaftar yang saat ini berjalan di bawah konteks keamanan grup Pengguna.

Sintaksis

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

Parameter

flags

Parameter ini dicadangkan untuk digunakan di masa mendatang dan harus diatur ke 0.

[out] ppRunningTasks

Antarmuka IRunningTaskCollection yang berisi semua instans tugas yang sedang berjalan di bawah konteks pengguna.

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.

Mengembalikan kode	Deskripsi
S_OK	Operasi berhasil diselesaikan.
E_INVALIDARG	Bendera non-null diteruskan ke parameter bendera .
E_POINTER	NULL diteruskan ke parameter ppRunningTasks.

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

IRegisteredTask

IRunningTaskCollection

Penjadwal Tugas

Bagikan melalui