IFilterRequestCallback::RequestFilter

要求來源提供者在變更列舉期間使用目的地提供者所提供的篩選。

HRESULT RequestFilter(
  IUnknown * pFilter,
  FILTERING_TYPE filteringType);

術語	定義
pFilter	[in] 目的地提供者所指定的篩選。這個篩選會傳遞給要在變更列舉期間使用的來源提供者。
filteringType	[in] 表示在篩選同步處理期間變更批次中所包含的資訊類型。

傳回值

S_OK。
E_POINTER。
如果來源提供者不支援 pFilter 所指定的篩選，則為 SYNC_E_FILTER_NOT_SUPPORTED。當來源提供者沒有實作 ISupportFilteredSync 時，也會傳回這個項目。

篩選交涉是使用下列步驟所達成：

在來源提供者開始列舉變更之前，Sync Framework 會呼叫目的地提供者上的 IRequestFilteredSync::SpecifyFilter 來啟動篩選交涉。
在處理 IRequestFilteredSync::SpecifyFilter 期間，目的地提供者會傳遞篩選至 IFilterRequestCallback::RequestFilter。
在 IFilterRequestCallback::RequestFilter 處理期間，Sync Framework 會呼叫來源提供者上的 ISupportFilteredSync::AddFilter。如果來源提供者不支援要求的篩選，目的地提供者就可以繼續要求篩選，直到它找到支援的篩選為止。

成功交涉篩選之後，來源提供者就會用它來判斷要在變更列舉期間包含哪些項目。