IRegisteredTask：：Run 方法（taskschd.h）

立即執行已註冊的工作。

語法

HRESULT Run(
  [in]            VARIANT      params,
  [out, optional] IRunningTask **ppRunningTask
);

[in] params

做為工作動作中值的參數。若要不指定工作動作的任何參數值，請將此參數設定為 VT_NULL 或 VT_EMPTY。否則，可以指定單一 BSTR 值或 BSTR 值的陣列。

您指定的 BSTR 值會與名稱配對，並儲存為名稱/值組。如果您指定單一 BSTR 值，則 Arg0 將會是指派給值的名稱。值可用於動作屬性中使用 $（Arg0）變數的工作動作。

如果您將 “0”、“100” 和 “250” 等值傳入為 BSTR 值的陣列，則 “0” 會取代 $（Arg0）變數，“100” 會取代 $（Arg1）變數，而 “250” 會取代動作屬性中使用的 $（Arg2）變數。

最多可以指定 32 BSTR 值。

如需可以使用 $（Arg0）、$（Arg1）、...、$（Arg32）變數值的詳細資訊和動作屬性清單，請參閱工作動作。

[out, optional] ppRunningTask

定義工作新實例的 IRunningTask 介面。

將參考傳遞至 NULLIRunningTask 介面指標。參考非NULL 指標可能會導致記憶體流失，因為將會覆寫指標。

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

這個方法會傳回而不會發生錯誤，但如果工作 ITaskSettings 的 AllowDemandStart 屬性設定為 false，工作將不會執行。

IRegisteredTask：：Run 函式相當於 IRegisteredTask：：RunEx 函式，其 flags 參數等於 0，而使用者參數等於 NULL。

如果從停用的工作叫用 IRegisteredTask：：Run，則會傳回SCHED_E_TASK_DISABLED。