ISimpleSyncProvider::UpdateItem
Wird von der Sync Framework-Laufzeit aufgerufen, um ein Element im Zielspeicher zu aktualisieren.
HRESULT UpdateItem(
IUnknown *pItemData,
const CHANGE_UNIT_SET *pChangeUnitsToUpdate,
const ITEM_FIELDS *pKeyAndExpectedVersionInfo,
IRecoverableErrorCallback *pRecoverableErrorCallback,
ITEM_FIELDS **ppUpdatedKeyAndVersionInfo,
BOOL *pfCommitKnowledgeAfterThisItem);
Parameter
- pItemData
[in] Daten für das Element in anbieterspezifischem Format.
- pChangeUnitsToUpdate
[in, unique] Ein CHANGE_UNIT_SET-Objekt, das die Änderungseinheiten enthält, die für ein Element aktualisiert werden sollen. Der Parameter sollte NULL (nicht leer) sein, wenn keine Änderungseinheiten angegeben sind.
pKeyAndExpectedVersionInfo
[in] Der Schlüssel und die erwarteten Versionseigenschaften des Elements, das aktualisiert werden soll.Der Anbieter muss eine vollständige Parallelitätsprüfung ausführen, um sicherzustellen, dass die Version des Elements am Ziel den in pKeyAndExpectedVersionInfo gefundenen Werten entspricht. Wenn diese Überprüfung fehlschlägt, sollte der Anbieter einen behebbaren Fehler melden.
- pRecoverableErrorCallback
[in] Ein IRecoverableErrorCallback-Objekt, das Methoden enthält, die aufgerufen werden können, wenn beim Aktualisieren eines Elements ein behebbarer Fehler auftritt.
- ppUpdatedKeyAndVersionInfo
[out] Gibt den Schlüssel und die aktualisierten Versionseigenschaften der aktualisierten Elemente zurück. Wenn der Rückgabewert nicht gültig ist, bricht die Sync Framework-Laufzeit die Sitzung ab.
- pfCommitKnowledgeAfterThisItem
[out] Gibt zurück, ob die Sync Framework-Laufzeit ein Commit für Wissen an den Metadatenspeicher durchführen sollte, nachdem die Verarbeitung für das angegebene Element abgeschlossen wurde.
Rückgabewert
- S_OK