IEnumTASK::Next-Methode (mmc.h)
Mit der IEnumTASK::Next-Methode kann MMC die nächste Aufgabe in der Aufgabenliste des Snap-Ins abrufen.
Syntax
HRESULT Next(
[in] ULONG celt,
[out] MMC_TASK *rgelt,
[out] ULONG *pceltFetched
);
Parameter
[in] celt
Ein Wert, der die Anzahl der bereitzustellenden Aufgaben angibt. MMC listet Aufgaben immer einzeln auf. daher ist celt immer 1.
[out] rgelt
Ein Zeiger auf eine MMC_TASK Struktur, die das Snap-In ausfüllt, um die Aufgabe darzustellen, die dem Taskpad hinzugefügt werden soll. Beachten Sie, dass der Aufrufer (MMC) den Arbeitsspeicher für die Struktur zuweist.
[out] pceltFetched
Ein Zeiger auf einen Wert, der die Anzahl der zurückgegebenen Aufgaben angibt. Wenn das Snap-In erfolgreich eine oder mehrere Aufgaben zurückgegeben hat, legen Sie den Wert auf die Anzahl der erfolgreich zurückgegebenen Aufgaben fest. Da MMC immer eine Aufgabe nach der anderen anfordert (celt ist immer 1), sollte pceltFetched auf 1 festgelegt werden, wenn die Aufgabe erfolgreich zurückgegeben wurde. Wenn das Snap-In keine weiteren Aufgaben in seiner Liste enthält oder das Snap-In die MMC_TASK-Struktur nicht ausgefüllt werden kann, legen Sie den Wert auf 0 fest.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
Hinweise
MMC ruft diese Methode auf, um die Liste der Aufgaben aufzulisten, die das Snap-In dem Taskpad hinzufügen muss. MMC ruft diese Methode auf, bis sie S_FALSE zurückgibt, um anzugeben, dass keine weiteren Aufgaben für das Snap-In zum Taskpad hinzugefügt werden können.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | mmc.h |