IKnowledgeSyncProvider::GetFullEnumerationChangeBatch
Obtiene un lote de cambios que contiene metadatos de elemento para los elementos cuyos identificadores son mayores que el límite inferior especificado, como parte de una enumeración completa.
Sintaxis
HRESULT GetFullEnumerationChangeBatch(
DWORD dwBatchSize,
const BYTE * pbLowerEnumerationBound,
ISyncKnowledge * pSyncKnowledge,
ISyncFullEnumerationChangeBatch ** ppSyncChangeBatch,
IUnknown ** ppUnkDataRetriever);
Parámetros
dwBatchSize
[in] Número de cambios que se van a incluir en el lote de cambios.pbLowerEnumerationBound
[in] Límite inferior para los identificadores de elemento. Este método devuelve cambios cuyos identificadores son mayores o iguales que este valor de identificador.pSyncKnowledge
[in] Si un cambio de elemento está contenido en este objeto de conocimiento, los datos de ese elemento ya existen en la réplica de destino.ppSyncChangeBatch
[out] Devuelve un lote de cambios que contiene metadatos de elemento para los elementos cuyos identificadores son mayores que el límite inferior especificado.ppUnkDataRetriever
[out] Devuelve un objeto que se puede usar para recuperar los datos de cambio. Puede ser un objeto ISynchronousDataRetriever o un objeto específico del proveedor.
Valor devuelto
S_OK
Códigos de error determinados por el proveedor
Notas
Sync Framework invoca este método durante la recuperación del conocimiento olvidado.
Este método enumera, por orden de identificador de elemento, los cambios cuyo identificador de elemento es mayor o igual que pbLowerEnumerationBound. Esto permite a Sync Framework determinar qué elementos del proveedor de destino se han eliminado pero han sido olvidados por el proveedor de origen. Opcionalmente, este método también puede agregar al lote los cambios, ordenados por identificador de elemento, cuyos identificadores de elemento sean menores que pbLowerEnumerationBound y que no estén contenidos en el conocimiento de destino.
Notas para los implementadores
Si no queda ningún cambio por enviar después de este lote, se debe llamar a ISyncChangeBatchBase::SetLastBatch en el lote de cambios devuelto. En caso contrario, Sync Framework llama de nuevo a GetFullEnumerationChangeBatch para recuperar otro lote de cambios.
Con un proveedor que envía datos de elemento junto con metadatos de cambio de elemento, se puede usar pSyncKnowledge para determinar si es necesario enviar los datos de elemento. Los datos de elemento no se tienen que enviar cuando el cambio de elemento está contenido en pSyncKnowledge. Tenga en cuenta que antes de poder usarlo para comprobar la contención de elementos, pSyncKnowledge se debe haber asignado mediante el método ISyncKnowledge::MapRemoteToLocal en el objeto de conocimiento contenido en el proveedor actual.