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 |