Antarmuka IRunnableTask (shobjidl_core.h)
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.
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) |