通过

IItemMetadata::SetGlobalId

设置项的全局 ID。

HRESULT SetGlobalId(
  const BYTE * pbGlobalId);

参数

  • pbGlobalId
    [in] 全局 ID。

返回值

  • S_OK

  • E_POINTER

  • E_OUTOFMEMORY

  • 如果已经设置了全局 ID，则返回值为 E_UNEXPECTED。

备注

全局 ID 的格式必须符合初始化副本时指定的 ID 格式架构。

每个 IItemMetadata 条目都需要有一个有效且唯一的全局 ID 值，才能保存到元数据存储区中。如果在全局 ID 无效的情况下调用了 IReplicaMetadata::SaveItemMetadata，则 IReplicaMetadata::SaveItemMetadata 返回 SYNC_E_METADATA_PRIMARY_KEY_CONSTRAINT。

备注

此方法不会将变更保存到存储区中。必须通过调用 IReplicaMetadata::SaveItemMetadata 才能保存对 IItemMetadata 属性所做的全部变更。

请参阅

参考

IItemMetadata 接口