IKnowledgeSyncProvider::GetFullEnumerationChangeBatch
Ruft einen Änderungsbatch mit Elementmetadaten für Elemente, deren IDs über der angegebenen Untergrenze liegen, als Teil einer vollständigen Enumeration ab.
HRESULT GetFullEnumerationChangeBatch(
DWORD dwBatchSize,
const BYTE * pbLowerEnumerationBound,
ISyncKnowledge * pSyncKnowledge,
ISyncFullEnumerationChangeBatch ** ppSyncChangeBatch,
IUnknown ** ppUnkDataRetriever);
Parameter
- dwBatchSize
[in] Die Anzahl von Änderungen, die der Änderungsbatch umfassen soll.
- pbLowerEnumerationBound
[in] Die Untergrenze für Element-IDs. Diese Methode gibt Änderungen zurück, deren IDs größer als oder gleich diesem ID-Wert sind.
- pSyncKnowledge
[in] Wenn dieses Wissensobjekt eine Elementänderung enthält, sind im Zielreplikat bereits Daten für dieses Element vorhanden.
- ppSyncChangeBatch
[out] Gibt einen Änderungsbatch mit Elementmetadaten für Elemente zurück, deren IDs größer als die festgelegte Untergrenze sind.
- ppUnkDataRetriever
[out] Gibt ein Objekt zurück, mit dem Änderungsdaten abgerufen werden können. Hierbei kann es sich um ein ISynchronousDataRetriever-Objekt oder ein anbieterspezifisches Objekt handeln.
Rückgabewert
S_OK
Vom Anbieter bestimmte Fehlercodes.
Hinweise
Diese Methode wird während der Wiederherstellung vergessenen Wissens von Sync Framework aufgerufen.
Diese Methode listet Änderungen, deren Element-ID gleich dem Wert pbLowerEnumerationBound oder größer ist, sortiert nach Element-ID auf. Dadurch kann Sync Framework bestimmen, welche Elemente des Zielanbieters gelöscht, jedoch vom Quellenanbieter vergessen wurden. Optional kann diese Methode dem Batch auch nach Element-ID sortierte Änderungen hinzufügen, deren Element-ID kleiner ist als pbLowerEnumerationBound und die nicht im Zielwissen enthalten sind.
Hinweise für Implementierer
Wenn nach diesem Batch keine zu sendenden Änderungen mehr vorliegen, muss ISyncChangeBatchBase::SetLastBatch für den zurückgegebenen Änderungsbatch aufgerufen werden. Andernfalls wird GetFullEnumerationChangeBatch von Sync Framework erneut aufgerufen, um einen weiteren Batch von Änderungen abzurufen.
Bei einem Anbieter, der Elementdaten zusammen mit Metadaten für Elementänderungen sendet, kann mithilfe von pSyncKnowledge bestimmt werden, ob es erforderlich ist, Elementdaten zu senden. Elementdaten müssen nicht gesendet werden, wenn die Elementänderung in pSyncKnowledge enthalten ist. Beachten Sie, dass pSyncKnowledge mit der ISyncKnowledge::MapRemoteToLocal-Methode für das Wissensobjekt im aktuellen Anbieter zugeordnet werden muss, bevor mit ihm überprüft werden kann, ob Elementänderungen enthalten sind.
Siehe auch
Verweis
IKnowledgeSyncProvider-Schnittstelle