ISyncChangeBatchBase::AddItemMetadataToGroup
Agrega el cambio de elemento especificado al grupo que se encuentra abierto.
Sintaxis
HRESULT AddItemMetadataToGroup(
const BYTE * pbOwnerReplicaId,
const BYTE * pbItemId,
const SYNC_VERSION * pChangeVersion,
const SYNC_VERSION * pCreationVersion,
DWORD dwFlags,
DWORD dwWorkForChange,
ISyncChangeBuilder ** ppChangeBuilder);
Parámetros
pbOwnerReplicaId
[in] Identificador de la réplica donde pChangeVersion y pCreationVersion son válidos. El formato del identificador debe coincidir con el formato especificado en la estructura ID_PARAMETERS del proveedor.pbItemId
[in] Identificador del elemento. El formato del identificador debe coincidir con el formato especificado en la estructura ID_PARAMETERS del proveedor.pChangeVersion
[in] Versión de este cambio.pCreationVersion
[in] Versión de creación del elemento.dwFlags
[in] Marcas que especifican el estado del cambio de elemento. Para obtener más información sobre los valores de las marcas, vea Marcas SYNC_CHANGE_FLAG.dwWorkForChange
[in] Estimación de trabajo para el cambio. Este valor se utiliza durante la aplicación de los cambios para notificar a la aplicación que el trabajo se ha completado.ppChangeBuilder
[in, out, unique] Devuelve un objeto que se puede usar para agregar información de la unidad de cambio al cambio.
Valor devuelto
S_OK
E_INVALIDARG si dwFlags contiene un valor de marca que no es válido.
SYNC_E_INVALID_OPERATION si no hay ningún grupo abierto, o si anteriormente se agregó un grupo vacío al lote.
SYNC_E_RANGE_OUT_OF_ORDER si un grupo ordenado está abierto y pbItemId es menor que el identificador del elemento anterior que se agregó al grupo o menor que el identificador de elemento que se especificó al abrir el grupo.
SYNC_E_CHANGE_BATCH_IS_READ_ONLY si el objeto ISyncChangeBatchBase se ha enviado a un aplicador de cambios o a la sesión de sincronización, o si el objeto se creó con IProviderSyncServices::DeserializeChangeBatch o IProviderSyncServices::DeserializeFullEnumerationChangeBatch.