IShellTaskScheduler::RemoveTasks method

Removes tasks from the scheduler's background queue.

Syntax

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

Parameters

rtoid

Type: REFTASKOWNERID

A GUID identifying the owner of the tasks to remove.

lParam

Type: DWORD_PTR

A pointer to a user-defined DWORD value that allows the task to be identified within the tasks owned by rtoid. Set this value to 0 to remove all tasks for the owner specified by rtoid.

bWaitIfRunning

Type: BOOL

TRUE if you want a currently running task to complete before removing it, FALSE otherwise.

Return Value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll (version 5.0 or later)