通过

ICoreFragment::NextColumn

返回此知识片段应用到的变更单位 ID 组中的下一个变更单位 ID。

HRESULT NextColumn(
  BYTE* pChangeUnitId,
  DWORD* pChangeUnitIdSize);

参数

术语

定义

pChangeUnitId

[in, out, unique, size_is(*pChangeUnitIdSize)] 返回集合中的下一个变更单位 ID。

pChangeUnitIdSize

[in, out] 指定 pChangeUnitId 中的字节数。如果 pChangeUnitId 太小，则返回检索 ID 所需的字节数；否则返回写入的字节数。

返回值

  • S_OK。

  • 如果没有更多要枚举的变更单位 ID，则返回值为 S_FALSE。

  • 如果变更单位 ID 是可变长度的 ID 并且 pChangeUnitIdSize 为 NULL，则返回值为 E_POINTER。

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

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

备注

ISyncKnowledge2 对象将包含一个或多个 ICoreFragment 对象。每个对象均包含应用于一组特定列**的知识。一列表示为一个变更单位。通常，其中某个 ICoreFragment 对象不包含列。当 ICoreFragment 对象不包含列时，该对象的知识将应用于未在任何其他片段中指定的所有变更单位。在这种情况下，NextColumn 始终返回 S_FALSE。

请参阅

参考

ICoreFragment 接口