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