IVssEnumObject：：Next 方法 (vss.h)

Next 方法从指定的枚举对象列表中返回指定数量的对象。

语法

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

[in] celt

要从枚举对象列表读取到 rgelt 缓冲区的元素数。

[out] rgelt

调用方分配的缓冲区的地址，该缓冲区接收 celtVSS_OBJECT_PROP 包含返回对象的结构。此参数是必需的，不能为 NULL。

[out] pceltFetched

rgelt 缓冲区中返回的元素数。

下面是此方法的有效返回代码。

请求返回多个 VSS_OBJECT_PROP 对象时，返回值 S_FALSE 表示已到达枚举列表的末尾。如果请求的对象数超过列表中保留的对象数， Next 将返回所有剩余对象，将 pceltFetched 参数设置为非零值，并返回S_FALSE。

输出 rgelt 参数必须指向包含 celtVSS_OBJECT_PROP 结构的已分配数组，并且不能为 NULL。

调用方负责将 IVssEnumObject：：Next 返回的系统资源释放到 rgelt 参数指向的VSS_OBJECT_PROP结构。

调用方必须为返回的 VSS_OBJECT_PROP 结构中VSS_SNAPSHOT_PROP或VSS_PROVIDER_PROP 对象中的每个字符串值使用 CoTaskMemFree。

在 VSS_SNAPSHOT_PROP的情况下，可以手动执行此操作，也可以使用实用工具函数 VssFreeSnapshotProperties 。