IRunnableTask-Schnittstelle (shobjidl_core.h)

  • Artikel

Eine Freithreadschnittstelle, die von einem -Objekt verfügbar gemacht werden kann, damit Vorgänge für einen Hintergrundthread ausgeführt werden können. Wenn die IExtractImage::GetLocation-Methode beispielsweise E_PENDING zurückgibt, darf die aufrufende Anwendung das Bild in einem Hintergrundthread extrahieren.

Vererbung

Die IRunnableTask-Schnittstelle erbt von der IUnknown-Schnittstelle . IRunnableTask verfügt auch über folgende Membertypen:

Methoden

Die IRunnableTask-Schnittstelle verfügt über diese Methoden.

 
IRunnableTask::IsRunning

Fordert Informationen zum Status einer Aufgabe an, z. B. die Miniaturansichtsextraktion.
IRunnableTask::Kill

Fordert an, dass eine Aufgabe beendet wird.
IRunnableTask::Resume

Fordert an, dass eine Aufgabe fortgesetzt wird.
IRunnableTask::Run

Fordert an, dass eine Aufgabe beginnt.
IRunnableTask::Suspend

Fordert an, dass eine Aufgabe angehalten wird.

Hinweise

Implementieren Sie IRunnableTask , wenn Ihre Namespaceerweiterung free-threaded ist und Sie zulassen möchten, dass eine Aufgabe, z. B. die Symbolextraktion, von einem Planer verwaltet wird. Es müssen nur die Methoden Run und IsRunning implementiert werden. Wenn Sie Kill, Resume und Suspend nicht implementieren möchten, geben Sie einfach E_NOTIMPL zurück.

Wenn Sie IRunnableTask verwenden, um ein Bild in einem Hintergrundthread zu extrahieren, d. h. wenn das Objekt IExtractImage verfügbar macht, ist Run nicht erforderlich, da das System IExtractImage::Extract zum Verwalten der Aufgabe verwendet. Die anderen Methoden (Kill, Resume und Suspend) sind in diesem Fall optional, werden jedoch vom System verwendet, wenn sie implementiert sind.

Sie rufen diese Schnittstelle nicht direkt auf. IRunnableTask wird vom Betriebssystem nur verwendet, wenn bestätigt wurde, dass Ihre Anwendung diese Schnittstelle kennt.

IRunnableTask implementiert IUnknown sowie die fünf aufgeführten Methoden.

Beachten SieWindows Vista und höher. Vor Windows Vista wurde diese Schnittstelle in Shlobj.h deklariert.
 

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)