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 |
|---|---|
|
Die Anzahl der abgerufenen Aufgaben entspricht der anzahl der angeforderten Aufgaben. |
|
Die zurückgegebene Zahl ist kleiner als die angeforderte Zahl. (Daher sind keine weiteren Aufgaben mehr aufzuzählen.) |
|
Ein Parameter ist ungültig. |
|
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 |