Método IFilter::GetText (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 de Windows 8. Em vez disso, use a Pesquisa do Windows para pesquisa do lado do cliente e o Microsoft Search Server Express para pesquisa no lado do servidor.

Recupera texto (propriedades do tipo texto) da parte atual, que deve ter um valor de enumeração CHUNKSTATE de CHUNK_TEXT.

Sintaxe

SCODE GetText(
  [in, out] ULONG *pcwcBuffer,
  [out]     WCHAR *awcBuffer
);

Parâmetros

[in, out] pcwcBuffer

Na entrada, o tamanho da matriz awcBuffer em caracteres largos/Unicode. Na saída, o número de caracteres Unicode gravados no awcBuffer.

[out] awcBuffer

Texto recuperado da parte atual. Não encerre o buffer com um caractere. Use uma cadeia de caracteres terminada em nulo. A cadeia de caracteres terminada em nulo não deve exceder o tamanho do buffer de destino.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 A operação foi concluída com êxito.
FILTER_E_NO_TEXT
O membro flags da estrutura STAT_CHUNK da parte atual não tem um valor de CHUNK_TEXT.
FILTER_E_NO_MORE_TEXT
Todo o texto na parte atual foi retornado. Chamadas adicionais para o método GetText devem retornar esse erro até que o método IFilter::GetChunk tenha sido chamado com êxito.
FILTER_S_LAST_TEXT
Como otimização, a última chamada que retorna texto pode retornar FILTER_S_LAST_TEXT, indicando que a próxima chamada para o método GetText retornará FILTER_E_NO_MORE_TEXT. Essa otimização pode economizar tempo eliminando chamadas desnecessárias para GetText.

Comentários

Se a parte atual for muito grande para a matriz awcBuffer , mais de uma chamada para o método GetText poderá ser necessária para recuperar todo o texto na parte atual. Cada chamada para o método GetText recupera o texto que segue imediatamente o texto da última chamada para o método GetText . O último caractere de uma chamada pode estar no meio de uma palavra, e o primeiro caractere na próxima chamada continuaria com essa palavra. Os mecanismos de pesquisa devem lidar com essa situação.

Requisitos

Requisito Valor
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

CHUNKSTATE

Ifilter