IUrlAccessor::BindToFilter Method

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

Syntax

HRESULT BindToFilter(      
    IFilter **ppFilter
);

Parameters

  • ppFilter
    [out]  Returns the address of a pointer to the IFilter that will be used to filter this item.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

Retrieves an IFilter so the gatherer can retrieve some properties.

This method is called only once by the Filter Host. If an item is a document with multiple embedded documents, you must use an IFilter implementation that enumerates the embedded documents and invokes the appropriate IFilter for each.

All protocol handlers must implement one of IUrlAccessor::BindToFilter, IUrlAccessor::BindToStream, or IUrlAccessor::GetFileName methods for the Filter Daemon to retrieve any useful information from an item. Protocol handlers may implement either IUrlAccessor::BindToFilter or IUrlAccessor::BindToStream or they may implement both. For example, protocol handlers may use IUrlAccessor::BindToFilter for metadata associated with items in the content source, and use IUrlAccessor::BindToStream to retrieve the content of the items.