Compartilhar via


Método IWordBreaker::BreakText (indexsrv.h)

Analisa o texto para identificar palavras e frases e fornece os resultados para os objetos IWordSink e IPhraseSink .

Sintaxe

HRESULT BreakText(
  [in] TEXT_SOURCE *pTextSource,
  [in] IWordSink   *pWordSink,
  [in] IPhraseSink *pPhraseSink
);

Parâmetros

[in] pTextSource

Tipo: TEXT_SOURCE*

Ponteiro para uma estrutura TEXT_SOURCE que contém texto Unicode.

[in] pWordSink

Tipo: IWordSink*

Ponteiro para o objeto IWordSink que recebe e manipula palavras geradas por esse método. NULL indica que esse método deve identificar apenas frases.

[in] pPhraseSink

Tipo: IPhraseSink*

Ponteiro para o objeto IPhraseSink que recebe e manipula frases geradas por esse método. NULL indica que esse método deve identificar palavras individuais, não frases.

Valor retornado

Tipo: HRESULT

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
Operação bem-sucedida. Não há mais texto disponível para recarregar o buffer pTextSource .
E_INVALIDARG
Argumento inválido. O parâmetro pTextSource é NULL.

Comentários

Como separadores de palavras geralmente analisam palavras do que frases, você deve otimizar para pPhraseSink = 0. PWordSink ou pPhraseSink podem ser NULL, mas não ambos.

O objeto IWordSink contém as palavras e suas formas alternativas para o separador de palavras. Formas alternativas de palavras, se existirem, são colocadas no objeto IWordSink primeiro, usando o método WordSink::P utAltWord e a palavra raiz é adicionada por último, usando o método WordSink::P utWord .

Use pfnFillTextBuffer, o elemento de ponteiro de função na estrutura TEXT_SOURCE , para repor o texto de origem. O método IWordBreaker::BreakText deve manipular todos os valores retornados de pfnFillTextBuffer . Se ocorrer um erro, conclua o processamento do texto no buffer antes de tratar o erro.

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 indexsrv.h
Redistribuível Pacote de Opções do Windows NT 4.0

Confira também

IWordBreaker

TEXT_SOURCE