ISpTaskManager::CreateReoccurringTask (Windows Embedded CE 6.0)

1/6/2010

This method creates a task entry that will be processed on a thread when the ISpNotifySink::Notify method is called on the task control object.

Syntax

HRESULT CreateReoccurringTask(
  ISpTask* pTask,
  void* pvTaskData,
  HANDLE hCompEvent,
  ISpNotifySink** ppTaskCtrl
);

pTask
[in] Pointer to an object implementing ISpTask that represents the task.

pvTaskData
[in] Pointer to data that will be passed to the ISpTask::Execute method.

hCompEvent
[in] Optional handle to the task completion event. This value can be NULL. If non-null, the event handle will be signaled when the ISpTask::Execute method returns

ppTaskCtrl
[out] Address of a pointer to an object implementing the ISpNotifySink interface. The application calls ISpNotifySink::Notify on this object to schedule the task.

The following table shows the possible return values.

Value	Description
S_OK	Function completed successfully.
E_INVALIDARG	pTask is invalid or bad.
E_POINTER	ppTaskCtrl is invalid or bad.
FAILED(hr)	Appropriate error message.