IScheduledWorkItem：：GetRunTimes 方法 (mstask.h)

  • 發行項

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

擷取指定時段 的工作專案 運行時間。

語法

HRESULT GetRunTimes(
  [in]      const LPSYSTEMTIME pstBegin,
  [in]      const LPSYSTEMTIME pstEnd,
  [in, out] WORD               *pCount,
  [out]     LPSYSTEMTIME       *rgstTaskTimes
);

參數

[in] pstBegin

SYSTEMTIME 結構的指標，其中包含要檢查之時段的開始時間。 此值為內含。

[in] pstEnd

SYSTEMTIME 結構的指標，其中包含要檢查之時間週期的結束時間。 這個值是獨佔的。 如果針對此值傳遞 NULL ，結束時間會無限。

[in, out] pCount

WORD 值的指標，指定要擷取的運行時間數目。

在輸入時，此參數包含要求的運行時間數目。 這可以是介於 1 到 TASK_MAX_RUN_TIMES之間的數目。

在輸出上，此參數包含擷取的運行時間數目。

[out] rgstTaskTimes

SYSTEMTIME 結構的陣列指標。 NULL LPSYSTEMTIME 對象應該傳遞至此參數。 傳回時，此陣列包含 pCount 執行時間。 您必須藉由呼叫 CoTaskMemFree 函式來釋放此陣列。

傳回值

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

傳回碼 描述
S_OK
 擷取要求的運行時間數目。
S_FALSE
 方法成功，但擷取的要求運行時間數目少。 所擷取的運行時間數目包含在 pCount 所指向的值中。 如果擷取的運行時間數目為零，也沒有任何事件型觸發程式可能會導致工作專案在指定的期間內執行。
SCHED_S_TASK_NO_VALID_TRIGGERS
 工作專案已啟用，但沒有有效的觸發程式。
SCHED_S_TASK_DISABLED
 工作專案已停用。
E_INVALIDARG
 一或多個引數無效。
E_OUTOFMEMORY
 記憶體不足，無法計算結果。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 mstask.h
程式庫 Mstask.lib
Dll Mstask.dll
可轉散發套件 Windows NT 4.0 和 Windows 95 上的 Internet Explorer 4.0 或更新版本

另請參閱

IScheduledWorkItem