RegisteredTask.RunEx 方法

針對腳本，請使用指定的旗標和會話識別碼，立即執行已註冊的工作。

語法

RegisteredTask.RunEx( _
  ByVal params, _
  ByVal flags, _
  ByVal sessionID, _
  ByRef runningTask _
)

params [in]

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

您指定的字串值會與名稱配對，並儲存為名稱/值組。如果您指定單一字串值，則 Arg0 會是指派給值的名稱。值可以在動作屬性中使用 $ (Arg0) 變數的工作動作。

如果您傳入「0」、「100」和「250」等值做為字串值的陣列，則「0」會取代 $ (Arg0) 變數，「100」會取代 $ (Arg1) 變數，而「250」會取代動作屬性中使用的 $ (Arg2) 變數。

最多可以指定 32 個字串值。

如需可以使用 $ (Arg0) 、$ (Arg1) ...、$ (Arg32) 變數值之動作屬性的清單，請參閱工作動作。

旗標 [in]

定義工作執行方式的TASK_RUN_FLAGS 常數。

sessionID [in]

您要在其中啟動工作的終端伺服器會話。

如果TASK_RUN_USE_SESSION_ID常數 (0x4) 未傳遞至 flags 參數，則會忽略此參數中指定的值。如果TASK_RUN_USE_SESSION_ID常數傳遞至 flags 參數，且 sessionID 值小於或等於 0，則會傳回不正確引數錯誤。

如果TASK_RUN_USE_SESSION_ID常數傳遞至 flags 參數，而 sessionID 值是大於 0 的有效會話識別碼，而且 如果使用者參數未 指定任何值，則工作排程器服務會嘗試以互動方式啟動工作，因為登入指定的會話的使用者。

如果TASK_RUN_USE_SESSION_ID常數傳遞至 flags 參數，而 sessionID 值是大於 0 的有效會話識別碼，而且如果使用者在 user 參數中指定使用者，則工作排程器服務會嘗試以互動方式啟動工作，作為使用者參數中指定的 使用者 。

runningTask [out]

定義工作新實例的 RunningTask 物件。

這個方法不會傳回值。

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