Freigeben über

IShellTaskScheduler::RemoveTasks-Methode (shobjidl_core.h)

  • Artikel

Entfernt Aufgaben aus der Hintergrundwarteschlange des Planers.

Syntax

HRESULT RemoveTasks(
  [in] REFTASKOWNERID rtoid,
  [in] DWORD_PTR      lParam,
  [in] BOOL           bWaitIfRunning
);

Parameter

[in] rtoid

Typ: REFTASKOWNERID

Eine GUID, die den Besitzer der zu entfernenden Aufgaben identifiziert.

[in] lParam

Typ: DWORD_PTR

Ein Zeiger auf einen benutzerdefinierten DWORD-Wert , mit dem die Aufgabe innerhalb der Aufgaben identifiziert werden kann, die sich im Besitz von rtoid befinden. Legen Sie diesen Wert auf 0 fest, um alle Aufgaben für den von rtoid angegebenen Besitzer zu entfernen.

[in] bWaitIfRunning

Typ: BOOL

TRUE , wenn eine aktuell ausgeführte Aufgabe vor dem Entfernen abgeschlossen werden soll, andernfalls FALSE .

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 (shobjidl.h einschließen)
DLL Shell32.dll (Version 5.0 oder höher)