IReplicaMetadata::SaveItemMetadata
將項目中繼資料變更儲存到中繼資料存放區。
HRESULT SaveItemMetadata(IItemMetadata * pItemMetadata);
參數
- pItemMetadata
[in] 要儲存到中繼資料存放區的項目中繼資料。
傳回值
S_OK
如果沒有變更要儲存,則為 S_FALSE。
如果 pItemMetadata 中指定的項目識別碼無效或重複,則為 SYNC_E_METADATA_PRIMARY_KEY_CONSTRAINT。
備註
必須呼叫這個方法,才能將 IItemMetadata 屬性變更儲存到中繼資料存放區。如果 IItemMetadata 屬性已變更,而且此物件被終結而未呼叫這個方法,這些變更將會遺失。
我們建議您在對應的變更已儲存到項目存放區之後,最好呼叫這個方法來儲存中繼資料變更。如此可幫助您確保在資料更新失敗時,將不會變更中繼資料。
這個類別的實作 (可透過 ISqlSyncMetadataStore 取得) 會在呼叫這個方法之前所啟動的交易內容中執行更新。
實作者注意事項
只有當中繼資料存放區成功認可所有屬性變更時,這個方法才會成功。不是必須認可所有的屬性變更,就是完全不認可。
如果中繼資料存放區支援交易,這個方法必須在該交易內容中,將它的變更套用到中繼資料存放區。