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。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mstask.h |
| 程式庫 | Mstask.lib |
| Dll | Mstask.dll |
| 可轉散發套件 | Windows NT 4.0 和 Windows 95 上的 Internet Explorer 4.0 或更新版本 |