IReplicaMetadata::GetChangeBatch
Obtiene un lote de cambios que contiene metadatos de elemento para los elementos no contenidos en el conocimiento especificado del proveedor de destino.
HRESULT GetChangeBatch(
DWORD dwBatchSize,
ISyncKnowledge *pSyncKnowledge,
ISyncChangeBatch ** ppSyncChangeBatch);
Parámetros
- dwBatchSize
[in] Tamaño del lote que se va a crear.
- pSyncKnowledge
[in] Conocimiento del proveedor de destino.
- ppSyncChangeBatch
[out] Devuelve un lote de cambios que contiene los metadatos del elemento para los elementos no contenidos en el conocimiento especificado del proveedor de destino.
Valor devuelto
S_OK
E_POINTER
E_INVALIDARG si dwBatchSize es 0.
Notas
Este método ayuda a un proveedor de sincronización a implementar su método IKnowledgeSyncProvider::GetChangeBatch.
Antes de que los proveedores llamen a este método, deben asegurarse de que las versiones del almacén de metadatos reflejan todos los cambios locales, incluso las eliminaciones. Esto se logra mediante un paso de mantenimiento de metadatos explícito para enumerar los elementos y actualizar sus metadatos.
La implementación de esta clase que está disponible mediante ISqlSyncMetadataStore agrega cambios ordenados según su identificador global al lote de cambios.
La implementación de esta clase que está disponible mediante ISqlSyncMetadataStore llama a SetLastBatch en el lote de cambios devuelto cuando no quedan cambios por enviar.
Notas para los implementadores
Para ayudar a un proveedor que usa la ordenación por identificadores globales y tiene la capacidad de usar intervalos, los cambios se deberían enumerar y agregar al lote de cambios de acuerdo con el orden de los identificadores globales. El primer cambio del lote de cambios devuelto inicia un nuevo intervalo.
Si no queda ningún cambio por enviar después de este lote, se debe llamar a SetLastBatch en el lote de cambios devuelto, o Sync Framework llamará de nuevo a IKnowledgeSyncProvider::GetChangeBatch para recuperar otro lote de cambios.