Interfaccia IRunnableTask (shobjidl_core.h)
Un'interfaccia a thread libero che può essere esposta da un oggetto per consentire l'esecuzione delle operazioni in un thread in background. Ad esempio, se il metodo IExtractImage::GetLocation restituisce E_PENDING, l'applicazione chiamante può estrarre l'immagine in un thread di sfondo.
Ereditarietà
L'interfaccia IRunnableTask eredita dall'interfaccia IUnknown . IRunnableTask include anche questi tipi di membri:
Metodi
L'interfaccia IRunnableTask include questi metodi.
| IRunnableTask::IsRunning Richiede informazioni sullo stato di un'attività, ad esempio l'estrazione dell'anteprima. |
| IRunnableTask::Kill Richiede che un'attività venga arrestata. |
| IRunnableTask::Resume Richiede la ripresa di un'attività. |
| IRunnableTask::Run Richiede che un'attività inizi. |
| IRunnableTask::Suspend Richiede che un'attività venga sospesa. |
Commenti
Implementare IRunnableTask se l'estensione dello spazio dei nomi è senza thread e si vuole consentire a un'attività come l'estrazione di icone di essere gestita da un utilità di pianificazione. È necessario implementare solo i metodi Run e IsRunning . Se non si vuole implementare Kill, Resume e Suspend, è sufficiente restituire E_NOTIMPL.
Se si usa IRunnableTask per estrarre un'immagine in un thread di sfondo, ovvero se l'oggetto espone IExtractImage, Run non è necessario, poiché il sistema userà IExtractImage::Extract per gestire l'attività. Gli altri metodi (Kill, Resume e Suspend) sono facoltativi in questo caso, ma verranno usati dal sistema se vengono implementati.
Questa interfaccia non viene chiamata direttamente. IRunnableTask viene usato dal sistema operativo solo quando ha confermato che l'applicazione è consapevole di questa interfaccia.
IRunnableTask implementa IUnknown e i cinque metodi elencati.
Requisiti
| Client minimo supportato | Windows 2000 Professional, Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | shobjidl_core.h (include Shobjidl.h) |