IFilter::BindRegion

Currently reserved for future use, can return E_NOTIMPL.

Retrieves an interface representing the specified portion of the object.

SCODE BindRegion(
  FILTERREGION origPos,
                //Position of text
  REFIID riid,  //Interface ID
  void ** ppunk //Address of output variable that receives the 
                //interface pointer requested in riid
);

Parameters

origPos: [in] Specifies FILTERREGION structure that contains the position of the text.
riid: [in] Reference to requested interface ID.
ppunk: [out] Address of pointer variable that receives the interface pointer requested in riid. Upon successful return, *ppunk contains the requested interface pointer.

Return Values

E_NOTIMPL: Currently not implemented.
FILTER_W_REGION_CLIPPED: IFilter couldn't bind the entire region.

Remarks

Characters extending beyond the end of a specified chunk should continue in the next chunk, with the same attribute. If this operation of binding an interface to the region is impossible, FILTER_W_REGION_CLIPPED should be returned. This situation can occur when the next such chunk is in a link or embedding.

Not all filters are capable of supporting this method in a rational way. Filters that are implemented by viewing applications will benefit the most from this method.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in filter.h.