IShellTaskScheduler::AddTask メソッド (shobjidl_core.h)

スケジューラのバックグラウンド キューにタスクを追加します。

構文

HRESULT AddTask(
  [in] IRunnableTask  *prt,
  [in] REFTASKOWNERID rtoid,
  [in] DWORD_PTR      lParam,
  [in] DWORD          dwPriority
);

パラメーター

[in] prt

種類: IRunnableTask*

キューに追加するタスクを表す IRunnableTask インターフェイスのインスタンスへのポインター。

[in] rtoid

種類: REFTASKOWNERID

タスクの所有者を識別する GUID。 この情報は、後で所有者がカウントまたは削除するためのタスクをグループ化するために使用できます。

[in] lParam

種類: DWORD_PTR

rtoid が所有するタスク内でタスクを識別できるようにする、ユーザー定義の DWORD 値へのポインター。 これは、単一のタスクを識別したり、サブグループ化したりするために使用されます。たとえば、タスクを ListView 内のアイテムなどの特定のアイテムに関連付けます。 このパラメーターには 0 を指定できます。

[in] dwPriority

型: DWORD

タスクの優先度を割り当てる次のいずれかの値。 この優先度に対する応答は、実行中の他のタスクの協力によって異なります。 新しいタスクは、優先度順にキューに挿入されます。 優先度の高いタスクが追加されたときに、優先度の低いタスクが現在実行中の場合、スケジューラは実行中のタスクの中断を試みます。 優先度の低いタスクは、優先度の高いタスクが完了すると再開されます。

ITSAT_DEFAULT_PRIORITY

スケジューラによってタスクに割り当てられた既定の優先度をそのまま使用します。

ITSAT_MAX_PRIORITY

優先度が高い。

ITSAT_MIN_PRIORITY

低優先度。

戻り値

種類: HRESULT

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

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll (バージョン 5.0 以降)