ISyncChangeBatchBase::AddItemMetadataToGroup
Ajoute une modification d'élément spécifiée au groupe qui est actuellement ouvert.
Syntaxe
HRESULT AddItemMetadataToGroup(
const BYTE * pbOwnerReplicaId,
const BYTE * pbItemId,
const SYNC_VERSION * pChangeVersion,
const SYNC_VERSION * pCreationVersion,
DWORD dwFlags,
DWORD dwWorkForChange,
ISyncChangeBuilder ** ppChangeBuilder);
Paramètres
pbOwnerReplicaId
[in] ID du réplica où pChangeVersion et pCreationVersion sont valides. Le format d'ID doit correspondre au format spécifié par la structure ID_PARAMETERS du fournisseur.pbItemId
[in] ID de l'élément. Le format d'ID doit correspondre au format spécifié par la structure ID_PARAMETERS du fournisseur.pChangeVersion
[in] Version de cette modification.pCreationVersion
[in] Version de création de l'élément.dwFlags
[in] Indicateurs qui spécifient l'état de la modification d'élément. Pour les valeurs d'indicateur, consultez Indicateurs SYNC_CHANGE_FLAG.dwWorkForChange
[in] Estimation du travail pour la modification. Cette valeur est utilisée pendant l'application des modifications pour signaler un travail achevé à l'application.ppChangeBuilder
[in, out, unique] Retourne un objet qui peut être utilisé pour ajouter des informations d'unité de modification à la modification.
Valeur de retour
S_OK
E_INVALIDARG lorsque dwFlags contient une valeur d'indicateur qui n'est pas valide.
SYNC_E_INVALID_OPERATION si aucun groupe n'est ouvert ou si un groupe vide a été ajouté précédemment au lot.
SYNC_E_RANGE_OUT_OF_ORDER lorsqu'un groupe ordonné est ouvert et que pbItemId est inférieur à l'ID de l'élément précédent qui a été ajouté au groupe ou inférieur à l'ID d'élément spécifié quand le groupe a été ouvert.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY lorsque l'objet ISyncChangeBatchBase a été envoyé à un applicateur de modifications ou à la session de synchronisation, ou lorsque l'objet a été créé en utilisant IProviderSyncServices::DeserializeChangeBatch ou IProviderSyncServices::DeserializeFullEnumerationChangeBatch.