IRegisteredTask::GetRunTimes-Methode (taskschd.h)

Ruft die Zeiten ab, zu denen die Ausführung des registrierten Tasks während eines angegebenen Zeitraums geplant ist.

Syntax

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

Parameter

[in] pstStart

Die Startzeit für die Abfrage.

[in] pstEnd

Die Endzeit für die Abfrage.

[in, out] pCount

Die angeforderte Anzahl von Ausführungen bei der Eingabe und die zurückgegebene Anzahl von Ausführungen bei der Ausgabe.

[out] pRunTimes

Die geplanten Zeiten, zu denen der Task ausgeführt wird. Ein NULL LPSYSTEMTIME-Objekt sollte an diesen Parameter übergeben werden. Bei der Rückgabe enthält dieses Array pCount-Laufzeiten . Sie müssen dieses Array freigeben, indem Sie die CoTaskMemFree-Funktion aufrufen.

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Wenn die Methode S_FALSE zurückgibt, enthält der pRunTimes-Parameter pCount-Elemente, aber es gab mehr Ausführungen der Aufgabe, die nicht zurückgegeben wurden. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Wenn der registrierte Task Trigger enthält, die einzeln deaktiviert sind, wirken sich diese Trigger weiterhin auf die nächste geplante Laufzeit aus, die zurückgegeben wird, obwohl sie deaktiviert sind.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	taskschd.h
Bibliothek	Taskschd.lib
DLL	Taskschd.dll

Weitere Informationen

IRegisteredTask

Aufgabenplanung