IEnumTASK::Next 方法 (mmc.h)

通过 IEnumTASK::Next 方法,MMC 可以在管理单元的任务列表中检索下一个任务。

语法

HRESULT Next(
  [in]  ULONG    celt,
  [out] MMC_TASK *rgelt,
  [out] ULONG    *pceltFetched
);

parameters

[in] celt

一个 值,该值指定要提供的任务数。 MMC 始终一次枚举一个任务;因此,celt 始终为 1。

[out] rgelt

指向 MMC_TASK 结构的指针,该结构由管理单元填充,表示要添加到任务板的任务。 请注意,MMC (调用方) 为结构分配内存。

[out] pceltFetched

指向一个值的指针,该值指定返回的任务数。 如果管理单元成功返回了一个或多个任务,请将值设置为成功返回的任务数。 由于 MMC 始终一次请求一个任务, (celt 始终为 1) ,因此如果成功返回任务,则 pceltFetched 应设置为 1。 如果管理单元列表中没有更多任务,或者管理单元未能填充MMC_TASK结构,请将值设置为 0。

返回值

此方法可以返回其中一个值。

注解

MMC 调用此方法以枚举管理单元必须添加到任务板的任务列表。 MMC 调用此方法,直到返回S_FALSE,以指示管理单元没有其他任务要添加到任务板。

要求

   
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 mmc.h

另请参阅

IExtendTaskPad

MMC_TASK

MMC_TASK_DISPLAY_BITMAP

MMC_TASK_DISPLAY_OBJECT

MMC_TASK_DISPLAY_SYMBOL