IShellTaskScheduler：：AddTask 方法 (shobjidl_core.h)

將工作新增至排程器的背景佇列。

語法

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

[in] prt

IRunnableTask 介面實例的指標，代表要新增至佇列的工作。

[in] rtoid

類型： REFTASKOWNERID

識別工作擁有者的 GUID。這項資訊可用來將工作分組，以供擁有者稍後進行計數或移除。

[in] lParam

類型： DWORD_PTR

使用者定義 DWORD 值的指標，可讓 工作在 rtoid 擁有的工作內加以識別。這可用來識別單一工作或將其子群組，例如將工作與 ListView 中的專案之類的特定專案產生關聯。此參數可以是零。

[in] dwPriority

類型： DWORD

下列其中一個值，其中一個值會指派工作的優先順序。回應此優先順序取決於正在執行的其他工作合作。新工作會依優先順序插入佇列中。如果新增較高優先順序的工作時，低優先順序的工作目前正在執行中，排程器會嘗試暫停執行中的工作。當完成較高優先順序的工作 () 時，就會繼續該較低優先順序的工作。

接受排程器指派給工作的預設優先順序。

高優先順序。

低優先順序。

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。