通过

ICoreFragment::NextRange

返回包含在此知识片段中的下一个范围以及定义有关范围中项的已知内容的时钟向量。

HRESULT NextRange(
  BYTE* pItemId,
  DWORD* pItemIdSize,
  IClockVector** piClockVector);

参数

  • pItemId
    [in, out, unique, size_is(*pItemIdSize)] 返回此范围中的项 ID 的封闭下限。如果此范围不是范围集中的第一个范围，则此值也是上一个范围中的项 ID 的开放上限。
  • pItemIdSize
    [in, out] 指定 pItemId 中的字节数。如果 pItemId 太小，则返回检索 ID 所需的字节数；否则返回写入的字节数。
  • piClockVector
    [out] 返回定义有关范围中项的已知内容的时钟向量。

返回值

  • S_OK

  • 如果没有更多要枚举的范围，则返回值为 S_FALSE。

  • 如果项 ID 是可变长度的 ID 并且 pItemIdSize 为 NULL，则返回值为 E_POINTER。

  • 如果 pItemId 太小，则返回值为 HRESULT_FROM_WIN32(ERROR_MORE_DATA)。在此情况下，将在 pItemIdSize 中返回必需的字节数。

  • 如果包含在此对象中的知识对象自创建此对象以来已经发生变更，则返回值为 SYNC_E_INVALID_OPERATION。

备注

pItemId 中返回的值是与 piClockVector 中返回的时钟向量相关联的项 ID 范围的封闭下限。pItemId 值还定义上一个范围的开放上限，以便可以通过再次调用 NextRange 获取当前范围的开放上限。如果没有更多要枚举的范围，则该范围将包含 ID 大于或等于 pItemId 的所有项。

请参阅

参考

ICoreFragment 接口