ISyncChangeBatchBase::AddItemMetadataToGroup

  • [アーティクル]

現在開いているグループに、指定された項目変更を追加します。

HRESULT AddItemMetadataToGroup(
  const BYTE * pbOwnerReplicaId, 
  const BYTE * pbItemId, 
  const SYNC_VERSION * pChangeVersion,
  const SYNC_VERSION * pCreationVersion, 
  DWORD dwFlags,
  DWORD dwWorkForChange,
  ISyncChangeBuilder ** ppChangeBuilder);

パラメーター

  • pbOwnerReplicaId
    [in] pChangeVersion および pCreationVersion が有効となっているレプリカのレプリカ ID です。ID の形式は、プロバイダーの ID_PARAMETERS 構造体によって指定された形式と一致する必要があります。
  • pbItemId
    [in] 項目の ID です。ID の形式は、プロバイダーの ID_PARAMETERS 構造体によって指定された形式と一致する必要があります。
  • pChangeVersion
    [in] この変更のバージョンです。
  • pCreationVersion
    [in] 項目の作成バージョンです。
  • dwFlags
    [in] 項目の変更状態を指定するフラグです。フラグの値については、「SYNC_CHANGE_FLAG フラグ」を参照してください。
  • dwWorkForChange
    [in] 変更の作業見積もりです。この値は、変更の適用時に、完了した作業をアプリケーションに報告するために使用されます。
  • ppChangeBuilder
    [in, out, unique] 変更単位の情報を変更へ追加するために使用できるオブジェクトを返します。

戻り値

  • S_OK

  • dwFlags が無効なフラグ値を格納している場合は E_INVALIDARG

  • グループが開いていないか、空のグループが以前にバッチに追加されている場合は SYNC_E_INVALID_OPERATION

  • 順序付けられているグループが開いており、pbItemId が、これまでにグループに追加された項目の項目 ID よりも小さい値になっているか、グループが開いたときに指定された項目 ID よりも小さい値になっている場合は、SYNC_E_RANGE_OUT_OF_ORDER

  • ISyncChangeBatchBase オブジェクトが変更適用元か同期セッションに送信されている場合、またはオブジェクトが IProviderSyncServices::DeserializeChangeBatch あるいは IProviderSyncServices::DeserializeFullEnumerationChangeBatch を使用して作成されている場合は、SYNC_E_CHANGE_BATCH_IS_READ_ONLY

参照

リファレンス

ISyncChangeBatchBase インターフェイス
SYNC_VERSION 構造体

概念

同期の進行状況の報告