IFilterTrackingSyncChangeBuilder::AddFilterChange

加入表示這項變更是否會造成項目移入或移出指定之篩選的資訊。

HRESULT AddFilterChange(
  DWORD                      dwFilterKey, 
  const SYNC_FILTER_CHANGE * pFilterChange);

參數

• dwFilterIndex
  [in] 複寫之篩選機碼對應中篩選的索引。

• pFilterChange
  [in] 相對於 dwFilterIndex 所指定之篩選的變更相關資訊。

傳回值

• S_OK。

• 如果 dwFilterIndex 是無效的值，則為 E_INVALIDARG。

• E_OUTOFMEMORY。

• E_POINTER。

• 如果 dwFilterIndex 的篩選變更資訊已經存在，則為 SYNC_E_INVALID_OPERATION。

備註

變更可能會導致項目移入或移出篩選。例如，項目會包含 state 欄位，而且篩選會排除其 state 欄位等於 "Washington" 的任何項目。當某個 state 等於 "Washington" 的項目變更，讓 state 等於 "Oregon" 時，此項目就會移入篩選。

表示追蹤篩選之複寫的提供者必須呼叫這個方法來設定有關所列舉之每項變更的篩選追蹤資訊。

請參閱

參考

IFilterTrackingSyncChangeBuilder 介面