3 out of 4 rated this helpful - Rate this topic

IFilter::BindRegion Method

[Indexing Service is no longer available for use as of Windows XP. Instead, use Windows Search.]

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

Syntax

Copy

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

Parameters

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 the following values.

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

Remarks

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.

Requirements

Minimum supported client	Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Header	Filter.h