ISyncRecordReference Class Reference

Overview

An ISyncRecordReference object provides a reusable and optionally persistent representation of a Sync Services record. For various reasons, a record identifier may change over time—for example, a record might be replaced during a refresh sync. Therefore, a record identifier might change when a record is logically the same. Alternatively, an ISyncRecordReference object provides a reliable reference to a Sync Services record that can be archived and shared among processes.

You do not create ISyncRecordReference objects directly. Instead, you use methods of the ISyncRecordSnapshot class, as follows: Use the recordReferenceForRecordWithIdentifier: method to get the ISyncRecordReference object associated with a given record identifier. Use the recordIdentifierForReference:isModified: method to get the record identifier associated with a given ISyncRecordSnapshot object. The record identifiers are in the scope of the associated record snapshot.

An ISyncRecordReference object conforms to the NSCoding protocol, and therefore can be archived and unarchived. Typically, clients archive record reference objects after a sync and unarchive them before a sync.