IScheduledWorkItem::GetRunTimes-Methode (mstask.h)

Artikel
02/29/2024

[[Diese API kann in nachfolgenden Versionen des Betriebssystems oder Produkts geändert oder nicht verfügbar sein. Verwenden Sie stattdessen die Taskplaner 2.0-Schnittstellen .] ]

Ruft die Laufzeiten des Arbeitselements für einen angegebenen Zeitraum ab.

Syntax

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

Parameter

[in] pstBegin

Ein Zeiger auf eine SYSTEMTIME-Struktur , die die Startzeit des zu überprüfenden Zeitraums enthält. Der Stop-Wert ist inklusiv.

[in] pstEnd

Ein Zeiger auf eine SYSTEMTIME-Struktur , die die Endzeit des zu überprüfenden Zeitraums enthält. Dieser Wert ist exklusiv. Wenn NULL für diesen Wert übergeben wird, ist die Endzeit unendlich.

[in, out] pCount

Ein Zeiger auf einen WORD-Wert , der die Anzahl der abzurufenden Ausführungszeiten angibt.

Bei der Eingabe enthält dieser Parameter die Anzahl der angeforderten Laufzeiten. Dies kann eine Anzahl zwischen 1 und TASK_MAX_RUN_TIMES sein.

In der Ausgabe enthält dieser Parameter die Anzahl der abgerufenen Laufzeiten.

[out] rgstTaskTimes

Ein Zeiger auf ein Array von SYSTEMTIME-Strukturen . An diesen Parameter sollte ein NULL LPSYSTEMTIME-Objekt übergeben werden. Bei der Rückgabe enthält dieses Array pCount-Laufzeiten . Sie müssen dieses Array durch einen Aufruf der CoTaskMemFree-Funktion freigeben.

Rückgabewert

Die GetRunTimes-Methode gibt einen der folgenden Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Die angeforderte Anzahl von Laufzeiten wurde abgerufen.
S_FALSE	Die Methode war erfolgreich, aber es wurden weniger als die angeforderte Anzahl von Laufzeiten abgerufen. Die Anzahl der abgerufenen Laufzeiten ist im Wert enthalten, auf den pCount verweist. Wenn die Anzahl der abgerufenen Ausführungszeiten null ist, gibt es auch keine ereignisbasierten Trigger, die dazu führen können, dass das Arbeitselement während des angegebenen Zeitraums ausgeführt wird.
SCHED_S_TASK_NO_VALID_TRIGGERS	Das Arbeitselement ist aktiviert, verfügt aber über keine gültigen Trigger.
SCHED_S_TASK_DISABLED	Das Arbeitselement ist deaktiviert.
E_INVALIDARG	Mindestens ein Argument ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher vorhanden, um das Ergebnis zu berechnen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mstask.h
Bibliothek	Mstask.lib
DLL	Mstask.dll
Verteilbare Komponente	Internet Explorer 4.0 oder höher unter Windows NT 4.0 und Windows 95

Weitere Informationen

IScheduledWorkItem

Freigeben über