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 エラー コードを返します。

解説

登録されたタスクに個別に無効になっているトリガーが含まれている場合、これらのトリガーは無効になっている場合でも、次に返されるスケジュールされた実行時間に影響します。

要件

こちらもご覧ください

IRegisteredTask

タスク スケジューラ