Freigeben über

IScheduledWorkItem::GetRunTimes-Methode (mstask.h)

  • Artikel

[[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