IReplicaMetadata 介面

提供中繼資料存放區內之複寫中繼資料和項目中繼資料的存取權。IReplicaMetadata 也會提供刪除偵測的服務及實作同步處理提供者方法的 Helper。

interface IReplicaMetadata : IUnknown

成員

IReplicaMetadata 可細分成下列各個概念性群組。

下列 IReplicaMetadata 成員可提供與複寫相關聯之中繼資料的存取權 (整體而言)。

IReplicaMetadata 方法	描述
IReplicaMetadata::GetReplicaId	取得與這個中繼資料相關聯之複寫的識別碼。
IReplicaMetadata::GetNextTickCount	針對這個複寫累加之前儲存的滴答計數、將新值儲存到存放區，並傳回新的值。
IReplicaMetadata::GetKnowledge	取得這個複寫的目前知識。
IReplicaMetadata::SetKnowledge	設定這個複寫的目前知識。
IReplicaMetadata::GetForgottenKnowledge	取得這個複寫的被遺忘的知識。
IReplicaMetadata::SetForgottenKnowledge	設定這個複寫的被遺忘的知識。
IReplicaMetadata::GetCustomFieldMetadata	取得與這個複寫相關聯的自訂中繼資料欄位。
IReplicaMetadata::SetCustomFieldMetadata	設定與這個複寫相關聯的自訂中繼資料欄位。
IReplicaMetadata::SaveReplicaMetadata	將複寫中繼資料變更儲存到中繼資料存放區。

注意

只有在已經呼叫 SaveReplicaMetadata 之後，使用這些屬性或方法在 IReplicaMetadata 執行個體 (Instance) 上所做的變更才會儲存到中繼資料存放區。

下列 IReplicaMetadata 成員可提供項目之中繼資料的存取權。

IReplicaMetadata 方法	描述
IReplicaMetadata::CreateEmptyFieldValue	建立包含預設值的新 IFieldValue 物件。
IReplicaMetadata::CreateNewItemMetadata	建立可用來將新項目中繼資料項目加入到中繼資料存放區的新 IItemMetadata 物件。
IReplicaMetadata::SaveItemMetadata	將項目中繼資料變更儲存到中繼資料存放區。
IReplicaMetadata::RemoveItemMetadataByGlobalId	從中繼資料存放區內移除項目中繼資料。
IReplicaMetadata::FindItemMetadataByGlobalId	取得具有所指定全域識別碼之項目的項目中繼資料。
IReplicaMetadata::FindItemMetadataByUniqueIndexedFields	傳回具有所指定索引欄位值的唯一項目中繼資料項目。
IReplicaMetadata::FindItemMetadataByIndexedFields	傳回具有所指定索引欄位值的項目中繼資料項目清單。
IReplicaMetadata::GetLastDeletedItemsCleanupTime	取得 CleanupDeletedItems 上次清除已刪除之項目的時間。
IReplicaMetadata::CleanupDeletedItems	如果從上次清除之後已經過指定的時間間隔，就會移除標示為已刪除的項目。
IReplicaMetadata::GetItemCount	取得中繼資料存放區內的項目總數，以及中繼資料存放區內的已刪除項目數。

注意

只有在已經呼叫 SaveItemMetadata 之後，IItemMetadata 執行個體上所做的屬性變更才會儲存到中繼資料存放區。

下列 IReplicaMetadata 成員可幫助實作同步處理提供者方法。

IReplicaMetadata 方法	描述
IReplicaMetadata::GetItemBatchVersions	取得包含此複寫內所儲存項目之版本的變更批次。這些項目會對應到在變更批次中傳送自某個其他提供者的項目。
IReplicaMetadata::GetFullEnumerationItemBatchVersions	取得包含此複寫內所儲存項目之版本的變更批次，此變更批次對應到從某個其他提供者所傳送項目中參考的變更批次 (完整列舉的一部分)。
IReplicaMetadata::GetChangeBatch	取得變更批次，其中包含目的地提供者之指定知識內未包含之項目的項目中繼資料。
IReplicaMetadata::GetFilteredChangeBatch	取得變更批次，其中包含目的地提供者之指定知識內未包含而且指定之靜態篩選或動態篩選所接受之項目的項目中繼資料。
IReplicaMetadata::GetFullEnumerationChangeBatch	取得變更批次，其中包含識別碼大於指定之下限之項目的項目中繼資料 (完整列舉的一部分)。

刪除偵測服務是一組 IReplicaMetadata 方法，可用來判斷哪些項目已從項目存放區刪除，所以應在中繼資料存放區內標示為已刪除。

IReplicaMetadata 方法	描述
IReplicaMetadata::ResetReportingWatermark	將所有項目標示為未報告，藉此重設刪除偵測服務。
IReplicaMetadata::ReportLiveItemByIndexedFields	報告由索引欄位值識別的項目仍在使用中，不應視為已刪除。
IReplicaMetadata::ReportLiveItemByGlobalId	報告這個指定項目仍在使用中，不應視為已刪除。
IReplicaMetadata::GetUnreportedItems	傳回目前在中繼資料存放區內未標示為使用中，而且尚未標示為已刪除的項目清單。
IReplicaMetadata::GetUnreportedItemsByIndexedFields	傳回具有指定的索引欄位值集合、目前在中繼資料存放區內未標示為使用中，而且尚未標示為已刪除的項目清單。

**標頭：**Metastore.h