ITask：：SetMaxRunTime 方法 (mstask.h)

[[此 API 可能會在後續版本的操作系統或產品中變更或無法使用。 請改用 工作排程器 2.0 介面 。] ]

這個方法會設定 工作 在終止之前可以執行的最大時間，以毫秒為單位。

語法

HRESULT SetMaxRunTime(
  [in] DWORD dwMaxRunTimeMS
);

參數

[in] dwMaxRunTimeMS

DWORD 值，指定工作的運行時間上限 (毫秒) 。 此參數可設定為 INFINITE，以指定無限制的時間。

傳回值

SetMaxRunTime 方法會傳回下列其中一個值。

備註

超過運行時間上限時，工作排程器會嘗試終止與工作相關聯的應用程式。 例如，如果無法傳送WM_CLOSE訊息 (，則應用程式沒有視窗) ，或應用程式未在接收WM_CLOSE的三分鐘內結束，則工作排程器會使用 TerminateProcess 終止應用程式。

設定運行時間上限之後，請務必呼叫 IPersistFile：：Save ，將修改的工作物件儲存到磁碟。

範例

如需如何設定運行時間上限的範例，請參閱 C/C++ 程式代碼範例：設定 MaxRunTime。

規格需求

另請參閱

IGetMaxRunTime

ITask