ISyncChangeWithFilterKeyMap::GetFilterChange
取得值,這個值會指出此項目是否已經位於指定的篩選中。
HRESULT GetFilterChange(
DWORD dwFilterKey,
SYNC_FILTER_CHANGE * pFilterChange);
參數
- dwFilterKey
[in] 可在目的地複寫之篩選機碼對應中識別篩選的機碼。
- pfHasBeenInTheFilter
[out] 傳回表示這項變更是否會造成項目移入或移出 dwFilterKey 所識別之篩選的資訊。
傳回值
S_OK。
如果來源提供者不會追蹤指定的篩選,則為 S_FALSE。
如果 dwFilterIndex 是無效的值,則為 E_INVALIDARG。
E_POINTER。
如果沒有追蹤指定的篩選,則為 SYNC_E_SOURCE_DOES_NOT_TRACK_FILTER。
備註
變更可能會導致項目移入或移出篩選。例如,項目會包含 state 欄位,而且篩選會排除其 state 欄位等於 "Washington" 的任何項目。當某個 state 等於 "Washington" 的項目變更,讓 state 等於 "Oregon" 時,此項目就會移入篩選。
表示追蹤篩選之複寫的目的地提供者必須呼叫這個方法來擷取套用至目的地複寫之每項變更的相關更新資訊。