Partager via

Interface IRunnableTask (shobjidl_core.h)

  • Article

Interface à thread libre qui peut être exposée par un objet pour permettre l’exécution d’opérations sur un thread d’arrière-plan. Par exemple, si la méthode IExtractImage::GetLocation retourne E_PENDING, l’application appelante est autorisée à extraire l’image sur un thread d’arrière-plan.

Héritage

L’interface IRunnableTask hérite de l’interface IUnknown. IRunnableTask a également les types de membres suivants :

Méthodes

L’interface IRunnableTask a ces méthodes.

 
IRunnableTask::IsRunning

Demande des informations sur l’état d’une tâche, telles que l’extraction de miniatures.
IRunnableTask::Kill

Demande qu’une tâche soit arrêtée.
IRunnableTask::Resume

Demande qu’une tâche reprenne.
IRunnableTask::Run

Demande qu’une tâche commence.
IRunnableTask::Suspend

Demande qu’une tâche soit suspendue.

Remarques

Implémentez IRunnableTask si votre extension d’espace de noms est libre et que vous souhaitez autoriser la gestion d’une tâche telle que l’extraction d’icônes par un planificateur. Seules les méthodes Run et IsRunning doivent être implémentées. Si vous ne souhaitez pas implémenter Kill, Resume et Suspend, il vous suffit de les renvoyer E_NOTIMPL.

Si vous utilisez IRunnableTask pour extraire une image sur un thread d’arrière-plan, autrement dit, si l’objet expose IExtractImage, exécuter n’est pas nécessaire, car le système utilisera IExtractImage::Extract pour gérer la tâche. Les autres méthodes (Kill, Resume et Suspend) sont facultatives dans ce cas, mais seront utilisées par le système si elles sont implémentées.

Vous n’appelez pas cette interface directement. IRunnableTask est utilisé par le système d’exploitation uniquement lorsqu’il a confirmé que votre application est au courant de cette interface.

IRunnableTask implémenteIUnknown ainsi que les cinq méthodes répertoriées.

NotezWindows Vista et versions ultérieures. Avant Windows Vista, cette interface était déclarée dans Shlobj.h.
 

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (inclure Shobjidl.h)