IFilterTrackingSyncChangeBuilder::AddFilterChange

  • [アーティクル]

この変更によって、指定されたフィルターに項目が追加されるか、指定されたフィルターから項目が除外されるかを示す情報を追加します。

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

パラメーター

  • dwFilterIndex
    [in] レプリカのフィルター キー マップ内のフィルターのインデックスです。
  • pFilterChange
    [in] dwFilterIndex によって指定されたフィルターに関連する変更に関する情報です。

戻り値

  • S_OK

  • E_INVALIDARG (dwFilterIndex が無効な値の場合)

  • E_OUTOFMEMORY

  • E_POINTER

  • SYNC_E_INVALID_OPERATION (dwFilterIndex のフィルター変更情報が既に存在する場合)

解説

変更によって、項目がフィルターに追加されたり、フィルターから除外されたりすることがあります。たとえば、項目に state フィールドが含まれており、state フィールドが "Washington" である項目をフィルターによって除外するとします。state フィールドが "Washington" である項目が変更されて state フィールドが "Oregon" になると、その項目はフィルターに追加されます。

フィルターを追跡するレプリカを表すプロバイダーは、このメソッドを呼び出して、列挙される各変更に関してフィルター追跡情報を設定する必要があります。

参照

リファレンス

IFilterTrackingSyncChangeBuilder インターフェイス