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.