Share via


IUrlAccessor::BindToFilter Method

Binds the item being processed to the appropriate IFilter and retrieves a pointer to the IFilter.

Syntax

HRESULT BindToFilter(      
    IFilter **ppFilter
);

Parameters

  • ppFilter
    [out] Receives the address of a pointer to the IFilter that can return metadata about the item being processed.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

This method retrieves an IFilter to enumerate the properties of the item associated with the specified URL, based on the protocol's information about that URL.

If the URL's content is also accessible from the IStream returned by IUrlAccessor::BindToStream, then a separate IFilter is invoked on the IStream to retrieve additional properties.