Metodo IFilter::GetText (filter.h)

  • Articolo

Nota

Il servizio di indicizzazione non è più supportato a partire da Windows XP e non è disponibile per l'uso a partire da Windows 8. Usare invece Windows Search per la ricerca sul lato client e Microsoft Search Server Express per la ricerca sul lato server.

Recupera il testo (proprietà di tipo testo) dal blocco corrente, che deve avere un valore di enumerazione CHUNKSTATE di CHUNK_TEXT.

Sintassi

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

Parametri

[in, out] pcwcBuffer

Nella voce le dimensioni della matrice awcBuffer in caratteri wide/Unicode. All'uscita, il numero di caratteri Unicode scritti in awcBuffer.

[out] awcBuffer

Testo recuperato dal blocco corrente. Non terminare il buffer con un carattere. Usare una stringa con terminazione null. La stringa con terminazione null non deve superare le dimensioni del buffer di destinazione.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
 L'operazione è stata completata correttamente.
FILTER_E_NO_TEXT
Il membro flag della struttura STAT_CHUNK per il blocco corrente non ha un valore di CHUNK_TEXT.
FILTER_E_NO_MORE_TEXT
Tutto il testo nel blocco corrente è stato restituito. Le chiamate aggiuntive al metodo GetText devono restituire questo errore finché il metodo IFilter::GetChunk non è stato chiamato correttamente.
FILTER_S_LAST_TEXT
Come ottimizzazione, l'ultima chiamata che restituisce testo può restituire FILTER_S_LAST_TEXT, indicando che la chiamata successiva al metodo GetText restituirà FILTER_E_NO_MORE_TEXT. Questa ottimizzazione può risparmiare tempo eliminando chiamate non necessarie a GetText.

Commenti

Se il blocco corrente è troppo grande per la matrice awcBuffer , è necessario più di una chiamata al metodo GetText per recuperare tutto il testo nel blocco corrente. Ogni chiamata al metodo GetText recupera il testo che segue immediatamente il testo dall'ultima chiamata al metodo GetText . L'ultimo carattere di una chiamata può trovarsi al centro di una parola e il primo carattere nella chiamata successiva continuerebbe tale parola. I motori di ricerca devono gestire questa situazione.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione filter.h

Vedi anche

CHUNKSTATE

Ifilter