IEnumWorkItems：：Next 方法 (mstask.h)
[[此 API 可能會在後續版本的操作系統或產品中變更或無法使用。 請改用 工作排程器 2.0 介面 。] ]
擷取列舉序列中下一個指定的工作數目。
如果序列中剩餘的工作數目少於所要求的數目，則會擷取其餘的所有元素。
語法
HRESULT Next(
[in] ULONG celt,
[out] LPWSTR **rgpwszNames,
[out] ULONG *pceltFetched
);
參數
[in] celt
要擷取的工作數目。
[out] rgpwszNames
指標陣列的指標， (LPWSTR) 為 null 終止的字元字串，其中包含從列舉序列傳回之工作的檔名。 這些檔名取自 [排程的工作] 資料夾 ，且擴展名為 “.job”。
處理 rgpwszNames 中傳回的名稱之後，您必須先釋放數位中的每個字元字串，然後使用 CoTaskMemFree 來釋放數位本身。
[out] pceltFetched
rgpwszNames 中傳回之工作的指標。 如果 celt 參數為 1，此參數可能是 NULL。
傳回值
傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
擷取的工作數目等於所要求的數目。 |
|
傳回的數位小於所要求的數位。 (因此，沒有其他工作可列舉.) |
|
有一個參數無效。 |
|
記憶體不足。 |
備註
IEnumWorkItems 介面也提供方法來重設列舉、略過工作，以及建立列舉目前狀態的複本。
範例
如需如何使用 Next 列舉 [排程的工作] 資料夾中的工作範例，請參閱 列舉工作範例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mstask.h |
| 程式庫 | Mstask.lib |
| Dll | Mstask.dll |
| 可轉散發套件 | Windows NT 4.0 和 Windows 95 上的 Internet Explorer 4.0 或更新版本 |