ITaskHandler::Start メソッド (taskschd.h)

COM ハンドラーを開始するために呼び出されます。このメソッドは、ハンドラーによって実装される必要があります。

構文

HRESULT Start(
  [in] IUnknown *pHandlerServices,
  [in] BSTR     data
);

[in] pHandlerServices

タスクスケジューラとの通信に使用される IUnkown インターフェイス。

[in] data

ハンドラーに必要な引数。これらの引数は、COM ハンドラーアクションの Data プロパティで定義されます。

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

このメソッドを実装する場合、ハンドラーはタスクスケジューラに直ちに制御を返す必要があります (inproc の場合は独自のスレッドを開始します)。

ハンドラーは、処理を開始した後、 UpdateStatus メソッドを呼び出して完了率を示すか、 TaskCompleted メソッドを呼び出してハンドラーが処理を完了したことを示すことができます。これらのメソッドは、 ITaskHandlerStatus インターフェイスによって提供されます。