Antarmuka IRunnableTask (shobjidl_core.h)

  • Artikel

Antarmuka berulir bebas yang dapat diekspos oleh objek untuk memungkinkan operasi dilakukan pada utas latar belakang. Misalnya, jika metode IExtractImage::GetLocation mengembalikan E_PENDING, aplikasi panggilan diizinkan untuk mengekstrak gambar pada utas latar belakang.

Warisan

Antarmuka IRunnableTask mewarisi dari antarmuka IUnknown . IRunnableTask juga memiliki jenis anggota ini:

Metode

Antarmuka IRunnableTask memiliki metode ini.

 
IRunnableTask::IsRunning

Meminta informasi tentang status tugas, seperti ekstraksi gambar mini.
IRunnableTask::Kill

Meminta agar tugas dihentikan.
IRunnableTask::Resume

Meminta tugas dilanjutkan.
IRunnableTask::Jalankan

Meminta tugas dimulai.
IRunnableTask::Tangguhkan

Meminta tugas ditangguhkan.

Keterangan

Terapkan IRunnableTask jika ekstensi namespace Anda berutas bebas, dan Anda ingin mengizinkan tugas seperti ekstraksi ikon dikelola oleh penjadwal. Hanya metode Jalankan dan IsRunning yang harus diimplementasikan. Jika Anda tidak ingin menerapkan Kill, Resume, dan Suspend, cukup minta mereka mengembalikan E_NOTIMPL.

Jika Anda menggunakan IRunnableTask untuk mengekstrak gambar pada utas latar belakang, yaitu, jika objek mengekspos IExtractImage, maka Jalankan tidak diperlukan, karena sistem akan menggunakan IExtractImage::Extract untuk mengelola tugas. Metode lain (Kill, Resume, dan Suspend) bersifat opsional dalam hal ini, tetapi akan digunakan oleh sistem jika diimplementasikan.

Anda tidak memanggil antarmuka ini secara langsung. IRunnableTask digunakan oleh sistem operasi hanya ketika telah mengonfirmasi bahwa aplikasi Anda mengetahui antarmuka ini.

IRunnableTask mengimplementasikan IUnknown serta lima metode yang tercantum.

PerhatikanWindows Vista dan yang lebih baru. Sebelum Windows Vista antarmuka ini dideklarasikan dalam Shlobj.h.
 

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header shobjidl_core.h (termasuk Shobjidl.h)