ISyncChangeBatchBase::AddItemMetadataToGroup
Agrega el cambio de elemento especificado al grupo que se encuentra abierto.
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 que se especifica 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] Marcadores que especifican el estado del cambio de elemento. Para obtener más información sobre los valores de los marcadores, vea Marcadores 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
[out] 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 marcador no 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.
Vea también
Referencia
Interfaz ISyncChangeBatchBase
Estructura SYNC_VERSION