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를 호출합니다. 원본 공급자에 지원되지 않는 필터를 요청한 경우 대상 공급자는 지원되는 필터를 찾을 때까지 계속 필터를 요청할 수 있습니다.

필터가 결정되면 원본 공급자에서 이 필터를 사용하여 변경 내용 열거 작업에 포함할 항목을 지정합니다.