從中繼資料存放區內移除項目中繼資料。
HRESULT RemoveItemMetadataByGlobalId(
const BYTE * pbGlobalId);
參數
- pbGlobalId
[in] 要移除之項目的識別碼。
傳回值
S_OK
E_POINTER
如果中繼資料存放區內沒有此項目，則為 SYNC_E_METADATA_ITEM_NOT_FOUND。
備註
這個方法的實作 (透過 ISqlSyncMetadataStore 取得) 會立即在存放區上執行此作業。如果有待處理的明確交易，此作業將會發生在這個交易內，而且如果此交易未認可或是已復原，就會復原此作業。
注意
這不是將項目標示為標記的正確方式。若要將項目標示為標記，請呼叫 IItemMetadata::MarkAsDeleted。提供者會使用 RemoveItemMetadataByGlobalId 來停止追蹤項目的中繼資料以及從中繼資料存放區完全移除此項目 (例如在標記清除期間)。