Condividi tramite


Interfaccia IFilter (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.

Analizza i documenti per le proprietà e il testo (chiamati anche attributi). Estrae blocchi di testo da questi documenti, filtrando la formattazione incorporata e conservando informazioni sulla posizione del testo. Estrae anche blocchi di valori, che sono proprietà di un intero documento o di parti ben definite di un documento. IFilter offre la base per la creazione di applicazioni di livello superiore, ad esempio indicizzatori di documenti e visualizzatori indipendenti dall'applicazione.

Per informazioni introduttive sul funzionamento dell'interfaccia IFilter con documenti e proprietà del documento, vedere Proprietà dei documenti. Per una sinopsi e un esempio di come l'interfaccia IFilter elabora un documento, vedere Filtro delle proprietà e indicizzazionedelle proprietà.

Ereditarietà

L'interfaccia IFilter eredita dall'interfaccia IUnknown . IFilter include anche questi tipi di membri:

Metodi

L'interfaccia IFilter include questi metodi.

 
IFilter::BindRegion

Recupera un'interfaccia che rappresenta la parte specificata dell'oggetto. Attualmente riservato per l'uso futuro.
IFilter::GetChunk

Posiziona il filtro all'inizio del blocco successivo o al primo blocco se si tratta della prima chiamata al metodo GetChunk e restituisce una descrizione del blocco corrente.
IFilter::GetText

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

Recupera un valore (proprietà di tipo valore interno) da un blocco, che deve avere un valore di enumerazione CHUNKSTATE di CHUNK_VALUE.
IFilter::Init

Inizializza una sessione di filtro.

Commenti

I componenti IFilter per il servizio di indicizzazione vengono eseguiti nel contesto di sicurezza locale e devono essere scritti per gestire i buffer e per eseguire correttamente lo stack. Tutte le copie di stringa devono disporre di controlli espliciti per proteggere gli overrun del buffer. È sempre necessario verificare la dimensione allocata del buffer e testare le dimensioni dei dati rispetto alle dimensioni del buffer.

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

BindIFilterFromStorage

BindIFilterFromStream

LoadIFilter