IProviderFilteredSyncServices::CreateFilterInfo
ISyncFilterInfo オブジェクトを作成します。同期元プロバイダーは、このオブジェクトを使用して、変更バッチに含める変更の制御に使用されるフィルターに関する情報を伝達できます。
HRESULT CreateFilterInfo(
DWORD dwFlags,
ISyncFilterInfo ** ppFilterInfo);
パラメーター
- dwFlags
[in] 作成されるフィルター情報オブジェクトに関する追加情報を指定するフラグです。SYNC_FILTER_INFO_FLAG_ITEM_LIST または SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST である必要があります。
- ppFilterInfo
[out] 新しく作成されたフィルター情報オブジェクトを返します。
戻り値
S_OK
E_INVALIDARG (dwFlags が SYNC_FILTER_INFO_FLAG_ITEM_LIST または SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST でない場合)
E_OUTOFMEMORY
E_POINTER
SYNC_E_INVALID_OPERATION (このオブジェクトが正しく初期化されていない場合)
解説
SYNC_FILTER_INFO_FLAG_ITEM_LIST が dwFlags の値に対して指定されている場合、Sync Framework は ISyncFilterInfo を実装するオブジェクトを返します。このオブジェクトで提供される実装では、ISyncFilterInfo::Serialize メソッドが呼び出されると、バージョン情報と、dwFlags に指定されるフラグをシリアル化します。
SYNC_FILTER_INFO_FLAG_CHANGE_UNIT_LIST が dwFlags の値に対して指定されている場合、Sync Framework は IChangeUnitListFilterInfo を実装するオブジェクトを返します。このオブジェクトで提供される実装を使用して、項目の特定の変更単位のセットのみが変更バッチに含まれるように指定できます。