Share via

IRegisteredTask：：GetRunTimes 方法 (taskschd.h)

  • 發行項

取得已註冊工作排定在指定時間執行的時間。

語法

HRESULT GetRunTimes(
  [in]      const LPSYSTEMTIME pstStart,
  [in]      const LPSYSTEMTIME pstEnd,
  [in, out] DWORD              *pCount,
  [out]     LPSYSTEMTIME       *pRunTimes
);

參數

[in] pstStart

查詢的開始時間。

[in] pstEnd

查詢的結束時間。

[in, out] pCount

在輸入上要求的回合數目，以及在輸出上傳回的執行數目。

[out] pRunTimes

工作將執行的排程時間。 NULL LPSYSTEMTIME 對象應該傳遞至此參數。 傳回時，此陣列包含 pCount 執行時間。 您必須呼叫 CoTaskMemFree 函式來釋放此陣列。

傳回值

如果方法成功，它會傳回 S_OK。 如果方法傳回S_FALSE，pRunTimes 參數會包含 pCount 專案，但未傳回的工作會執行更多。 否則，它會傳回 HRESULT 錯誤碼。

備註

如果已註冊的工作包含個別停用的觸發程式，這些觸發程式仍會影響傳回的下一個排程運行時間，即使已停用。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 taskschd.h
程式庫 Taskschd.lib
Dll Taskschd.dll

另請參閱

IRegisteredTask

工作排程器