Metode IRegisteredTask::GetInstances (taskschd.h)

  • Artikel

Mengembalikan semua instans tugas terdaftar yang sedang berjalan.

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

 

Sintaks

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

Parameter

flags

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

[out] ppRunningTasks

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

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

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

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

Persyaratan

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

Lihat juga

IRegisteredTask

IRunningTaskCollection

Tugas Microsoft Azure Scheduler