Metodo IFilter::GetText (filter.h)
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 |
|---|---|
|
L'operazione è stata completata correttamente. |
|
Il membro flag della struttura STAT_CHUNK per il blocco corrente non ha un valore di CHUNK_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. |
|
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 |