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 或更新版本