Export (0) Print
Expand All
3 out of 4 rated this helpful - Rate this topic

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.

Syntax


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 these values.

Return codeDescription
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 (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

Header

Filter.h

See also

IFilter

 

 

Build date: 9/10/2012

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.