Metode ITask::SetPriority (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.] ]

Metode ini menetapkan prioritas untuk tugas.

Sintaks

HRESULT SetPriority(
  [in] DWORD dwPriority
);

Parameter

[in] dwPriority

DWORD yang menentukan prioritas untuk tugas saat ini. Prioritas tugas menentukan frekuensi dan panjang irisan waktu untuk proses. Ini hanya berlaku untuk sistem operasi Windows Server 2003, Windows XP, dan Windows 2000. Nilai-nilai ini diambil dari kelas prioritas CreateProcess dan dapat menjadi salah satu bendera berikut (dalam urutan turun prioritas penjadwalan utas):

  • REALTIME_PRIORITY_CLASS
  • HIGH_PRIORITY_CLASS
  • NORMAL_PRIORITY_CLASS
  • IDLE_PRIORITY_CLASS

Nilai kembali

Metode SetPriority mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
S_OK
 Operasi berhasil.
E_INVALIDARG
 Argumen tidak valid.

Keterangan

Setelah mengatur prioritas tugas, panggil IPersistFile::Save untuk menyimpan objek tugas yang dimodifikasi ke disk.

Contoh

Untuk informasi selengkapnya dan contoh cara mengatur prioritas tugas, lihat Contoh Kode C/C++: Mengatur Prioritas Tugas.

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

Lihat juga

GetPriority

ITask