IFilter::BindRegion method (filter.h)


Indexing Service is no longer supported as of Windows XP and is unavailable for use as of Windows 8. Instead, use Windows Search for client side search and Microsoft Search Server Express for server side search.

Retrieves an interface representing the specified portion of object. Currently reserved for future use.


SCODE BindRegion(
  [in]  FILTERREGION origPos,
  [in]  REFIID       riid,
  [out] void         **ppunk


[in] origPos

A FILTERREGION structure that contains the position of the text.

[in] riid

A reference to the requested interface identifier.

[out] ppunk

A pointer to a variable that receives the interface pointer requested in riid. Upon successful return, *ppunk contains the requested interface pointer.

Return value

This method can return one of these values.

Return code Description
The operation was completed successfully.
This method is not currently implemented.
The filter could not bind the entire region.


If it is impossible for the BindRegion method to bind an interface to the specified region, return FILTER_W_REGION_CLIPPED. This situation can occur when the next such chunk is in a linked object or an embedded object.

Not all filters are capable of supporting the BindRegion method in a rational way. Filters that are implemented by viewing applications will benefit the most from this method. The method is intended to be a way to pass cookies through the search engine and back to the IFilter interface implementation.

Notes to Implementers

This method is currently reserved for future use. Always return E_NOTIMPL.


Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header filter.h

See also