Método IFilter::BindRegion (filter.h)

  • Artigo

Observação

O Serviço de Indexação não tem mais suporte a partir do Windows XP e não está disponível para uso a partir do Windows 8. Em vez disso, use a pesquisa do lado do cliente da Pesquisa do Windows e o Microsoft Search Server Express para pesquisa no lado do servidor.

Recupera uma interface que representa a parte especificada do objeto. Atualmente reservado para uso futuro.

Sintaxe

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

Parâmetros

[in] origPos

Uma estrutura FILTERREGION que contém a posição do texto.

[in] riid

Uma referência ao identificador de interface solicitado.

[out] ppunk

Um ponteiro para uma variável que recebe o ponteiro de interface solicitado em riid. Após o retorno bem-sucedido, *ppunk contém o ponteiro de interface solicitado.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 A operação foi concluída com êxito.
E_NOTIMPL
 No momento, esse método não está implementado.
FILTER_W_REGION_CLIPPED
 O filtro não pôde associar toda a região.

Comentários

Se for impossível para o método BindRegion associar uma interface à região especificada, retorne FILTER_W_REGION_CLIPPED. Essa situação pode ocorrer quando a próxima parte desse tipo estiver em um objeto vinculado ou em um objeto inserido.

Nem todos os filtros são capazes de dar suporte ao método BindRegion de maneira racional. Os filtros implementados pela exibição de aplicativos serão os que mais se beneficiarão desse método. O método destina-se a ser uma maneira de passar cookies pelo mecanismo de pesquisa e voltar para a implementação da interface IFilter .

Anotações aos implementadores

No momento, este método está reservado para uso futuro. Sempre retorne E_NOTIMPL.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho filter.h

Confira também

Ifilter