共用方式為

IRunnableTask 介面 (shobjidl_core.h)

  • 發行項

可由 物件公開的自由執行緒介面，以允許在背景執行緒上執行作業。 例如，如果 IExtractImage：：GetLocation 方法傳回E_PENDING，則允許呼叫的應用程式在背景執行緒上擷取影像。

繼承

IRunnableTask介面繼承自IUnknown介面。 IRunnableTask 也有下列類型的成員：

方法

IRunnableTask介面具有這些方法。

 
IRunnableTask：：IsRunning

要求工作狀態的相關資訊，例如縮圖擷取。
IRunnableTask：：Kill

要求停止工作。
IRunnableTask：：Resume

要求工作繼續。
IRunnableTask：：Run

要求工作開始。
IRunnableTask：：Suspend

要求暫停工作。

備註

如果您的命名空間延伸模組是自由執行緒，而且您想要允許排程器管理圖示擷取之類的工作，請實作 IRunnableTask 。 只能實作 Run 和 IsRunning 方法。 如果您不想實作 Kill、 Resume和 Suspend，只要傳回E_NOTIMPL即可。

如果您使用 IRunnableTask 在背景執行緒上擷取影像，也就是說，如果物件公開 IExtractImage，則不需要 執行 ，因為系統會使用 IExtractImage：：Extract 來管理工作。 在此案例中，其他方法 (Kill、 Resume和 Suspend) 都是選擇性的，但如果實作，則會由系統使用。

您不會直接呼叫此介面。 只有在作業系統確認您的應用程式知道此介面時，才會使用IRunnableTask。

IRunnableTask 會實作 IUnknown 以及五個列出的方法。

記下Windows Vista 和更新版本。 在 Windows Vista 之前，此介面已在 Shlobj.h 中宣告。
 

規格需求

   
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shobjidl.h)