BindToFilter Method

Binds to the appropriate Filter object for the item and returns a pointer to it.

HRESULT BindToFilter(
IFilter **ppFilter
);

Parameters

ppFilter

[out] The address of a pointer to the Filter object that will be used to filter this item.

Return Value

If successful, returns S_OK, otherwise it returns an error value. For a list of error messages returned by Enterprise Search in Microsoft Office SharePoint Server 2007, see Protocol Handler Error Messages.

Remarks

Retrieves a Filter object, so the Enterprise Search crawler can retrieve metadata for the item.

This method is called only once by the Filter Daemon. If a content item contains multiple embedded items, you must use an implementation of the IFilter interface that enumerates the embedded content items and invokes the appropriate Filter object for each.

For the Filter Daemon to retrieve any useful information for an item, the protocol handler must implement one of the following IUrlAccessor methods:

.

Protocol handlers can implement either the BindToFilter or BindToStream methods of the IURLAccessor interface, or they can implement both. For example, protocol handlers can use the BindToFilter method for metadata associated with items in the content source, and use the BindToStream method to retrieve the actual content of the items.

See Also

Concepts

Protocol Handler Reference
IUrlAccessor Interface