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 が返されます。

注意

このメソッドでは変更がストアに保存されません。IItemMetadata プロパティに加えたすべての変更を保存するには、IReplicaMetadata::SaveItemMetadata を呼び出す必要があります。

参照

リファレンス

IItemMetadata インターフェイス