ISpTaskManager::CreateReoccurringTask

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.

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

Parameters

  • 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.

Return Values

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.

Requirements

OS Versions: Windows CE .NET 4.1 and later.
Header: Sapiddk.h, Sapiddk.idl.
Link Library: Sapilib.lib.

See Also

ISpTaskManager | SAPI Interfaces

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.