Compartir a través de

Interfaz IRunnableTask (shobjidl_core.h)

  • Artículo

Interfaz de subproceso libre que un objeto puede exponer para permitir que las operaciones se realicen en un subproceso en segundo plano. Por ejemplo, si el método IExtractImage::GetLocation devuelve E_PENDING, la aplicación que realiza la llamada puede extraer la imagen en un subproceso de fondo.

Herencia

La interfaz IRunnableTask hereda de la interfaz IUnknown . IRunnableTask también tiene estos tipos de miembros:

Métodos

La interfaz IRunnableTask tiene estos métodos.

 
IRunnableTask::IsRunning

Solicita información sobre el estado de una tarea, como la extracción de miniaturas.
IRunnableTask::Kill

Solicita que se detenga una tarea.
IRunnableTask::Resume

Solicita que se reanude una tarea.
IRunnableTask::Run

Solicita que se inicie una tarea.
IRunnableTask::Suspend

Solicita que se suspenda una tarea.

Comentarios

Implemente IRunnableTask si la extensión de espacio de nombres está libre en subproceso y quiere permitir que un programador administre una tarea como la extracción de iconos. Solo se deben implementar los métodos Run e IsRunning . Si no desea implementar Kill, Resume y Suspend, simplemente haga que devuelvan E_NOTIMPL.

Si usa IRunnableTask para extraer una imagen en un subproceso de fondo, es decir, si el objeto expone IExtractImage, ejecutar no es necesario, ya que el sistema usará IExtractImage::Extract para administrar la tarea. Los demás métodos (Kill, Resume y Suspend) son opcionales en este caso, pero el sistema los usará si se implementan.

No se llama directamente a esta interfaz. El sistema operativo usa IRunnableTask solo cuando ha confirmado que la aplicación es consciente de esta interfaz.

IRunnableTask implementa IUnknown , así como los cinco métodos enumerados.

Tenga en cuentaWindows Vista y versiones posteriores. Antes de Windows Vista, esta interfaz se declaró en Shlobj.h.
 

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)