IFilterRequestCallback::RequestFilter

Artikel
11/02/2009

Fordert an, dass der vom Zielanbieter bereitgestellte Filter vom Quellenanbieter während der Änderungsenumeration verwendet wird.

HRESULT RequestFilter(
  IUnknown * pFilter,
  FILTERING_TYPE filteringType);

Parameter

Ausdruck	Definition
pFilter	[in] Der Filter, der vom Zielanbieter angegeben wird. Dieser Filter wird dem Quellenanbieter zur Verwendung während der Änderungsenumeration übergeben.
filteringType	[in] Gibt den Typ von Informationen an, die während der gefilterten Synchronisierung in einem Änderungsbatch berücksichtigt werden.

Rückgabewert

S_OK.
E_POINTER.
SYNC_E_FILTER_NOT_SUPPORTED, wenn der von pFilter angegebene Filter vom Quellenanbieter nicht unterstützt wird. Dies wird auch zurückgegeben, wenn der Quellenanbieter ISupportFilteredSync nicht implementiert.

Hinweise

Die Filteraushandlung wird mit den folgenden Schritten durchgeführt:

Bevor der Quellenanbieter mit der Auflistung der Änderungen beginnt, startet Sync Framework die Filteraushandlung durch das Aufrufen von IRequestFilteredSync::SpecifyFilter auf dem Zielanbieter.
Während der Verarbeitung von IRequestFilteredSync::SpecifyFilter übergibt der Zielanbieter Filter an IFilterRequestCallback::RequestFilter.
Während der Verarbeitung von IFilterRequestCallback::RequestFilter ruft Sync Framework auf dem Quellenanbieter ISupportFilteredSync::AddFilter auf. Wenn der Quellenanbieter den angeforderten Filter nicht unterstützt, kann der Zielanbieter weiterhin Filter anfordern, bis ein unterstützter Filter gefunden wird.

Wenn ein Filter erfolgreich ausgehandelt wurde, wird er vom Quellenanbieter zur Festlegung der während der Änderungsenumeration einzuschließenden Elemente verwendet.

Siehe auch

Verweis

IFilterRequestCallback-Schnittstelle
IRequestFilteredSync-Schnittstelle
ISupportFilteredSync-Schnittstelle

Freigeben über