IEnumWorkItems::Next-Methode (mstask.h)

[[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 nächste angegebene Anzahl von Aufgaben in der Enumerationssequenz ab.

Wenn weniger als die angeforderte Anzahl von Aufgaben in der Sequenz vorhanden ist, werden alle verbleibenden Elemente abgerufen.

Syntax

HRESULT Next(
  [in]  ULONG  celt,
  [out] LPWSTR **rgpwszNames,
  [out] ULONG  *pceltFetched
);

Parameter

[in] celt

Die Anzahl der abzurufenden Aufgaben.

[out] rgpwszNames

Ein Zeiger auf ein Array von Zeigern (LPWSTR) auf NULL-Zeichenfolgen, die die Dateinamen der aus der Enumerationssequenz zurückgegebenen Aufgaben enthalten. Diese Dateinamen werden aus dem Ordner Geplante Aufgaben übernommen und verfügen über die Erweiterung ".job".

Nach der Verarbeitung der in rgpwszNames zurückgegebenen Namen müssen Sie zunächst jede Zeichenfolge im Array und dann das Array selbst mithilfe von CoTaskMemFree freigeben.

[out] pceltFetched

Ein Zeiger auf die Anzahl der in rgpwszNames zurückgegebenen Aufgaben. Wenn der celt-Parameter 1 ist, kann dieser Parameter NULL sein.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Die Anzahl der abgerufenen Aufgaben entspricht der anzahl der angeforderten Aufgaben.
S_FALSE	Die zurückgegebene Zahl ist kleiner als die angeforderte Zahl. (Daher sind keine weiteren Aufgaben mehr aufzuzählen.)
E_INVALIDARG	Ein Parameter ist ungültig.
E_OUTOFMEMORY	Es ist nicht genügend Arbeitsspeicher verfügbar.

Hinweise

Die IEnumWorkItems-Schnittstelle bietet auch Methoden zum Zurücksetzen der Enumeration, zum Überspringen von Aufgaben und zum Erstellen einer Kopie des aktuellen Zustands der Enumeration.

Beispiele

Ein Beispiel für die Verwendung von Next zum Auflisten der Aufgaben im Ordner Geplante Aufgaben finden Sie unter Enumerating Tasks Example.

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

IEnumWorkItems

IEnumWorkItems::Clone

IEnumWorkItems::Reset

IEnumWorkItems::Skip