BindRegion Method
Collapse the table of content
Expand the table of content

IFilter::BindRegion method

[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.


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


origPos [in]

A FILTERREGION structure that contains the position of the text.

riid [in]

A reference to the requested interface identifier.

ppunk [out]

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 codeDescription

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.


Minimum supported client

Windows 2000 Professional (desktop apps only)

Minimum supported server

Windows 2000 Server (desktop apps only)

End of client support

Windows 7

End of server support

Windows Server 2008 R2



See also




Build date: 9/10/2012

Community Additions

© 2015 Microsoft