IShellTaskScheduler::AddTask-Methode (shobjidl_core.h)

Artikel
03/09/2024

Fügt der Hintergrundwarteschlange des Planers eine Aufgabe hinzu.

Syntax

HRESULT AddTask(
  [in] IRunnableTask  *prt,
  [in] REFTASKOWNERID rtoid,
  [in] DWORD_PTR      lParam,
  [in] DWORD          dwPriority
);

Parameter

[in] prt

Typ: IRunnableTask*

Ein Zeiger auf eine instance einer IRunnableTask-Schnittstelle, die die Aufgabe darstellt, die der Warteschlange hinzugefügt werden soll.

[in] rtoid

Typ: REFTASKOWNERID

Eine GUID, die den Besitzer der Aufgabe identifiziert. Diese Informationen können verwendet werden, um Aufgaben zum späteren Zählen oder Entfernen nach Besitzer zu gruppieren.

[in] lParam

Typ: DWORD_PTR

Ein Zeiger auf einen benutzerdefinierten DWORD-Wert , mit dem die Aufgabe innerhalb der Aufgaben identifiziert werden kann, die zu rtoid gehören. Dies wird verwendet, um einzelne Aufgaben zu identifizieren oder sie zu untergruppieren, um instance die Aufgabe einem bestimmten Element zuzuordnen, z. B. einem Element in einer ListView. Dieser Parameter kann 0 sein.

[in] dwPriority

Art: DWORD

Einer der folgenden Werte, der die Priorität der Aufgabe zuweist. Die Reaktion auf diese Priorität hängt von der Zusammenarbeit der anderen ausgeführten Aufgaben ab. Neue Aufgaben werden in der Warteschlange in der Prioritätsreihenfolge eingefügt. Wenn eine Aufgabe mit niedriger Priorität derzeit ausgeführt wird, wenn eine Aufgabe mit höherer Priorität hinzugefügt wird, versucht der Planer, die Ausführung des Vorgangs anzuhalten. Diese Aufgabe mit niedrigerer Priorität wird fortgesetzt, wenn die Aufgaben mit höherer Priorität abgeschlossen werden.

ITSAT_DEFAULT_PRIORITY

Übernehmen Sie die Standardpriorität, die der Aufgabe vom Planer zugewiesen wurde.

ITSAT_MAX_PRIORITY

Hohe Priorität.

ITSAT_MIN_PRIORITY

Niedrige Priorität.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)
DLL	Shell32.dll (Version 5.0 oder höher)

Freigeben über