IRunnableTask-Schnittstelle (shobjidl_core.h)
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.
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) |