Condividi tramite


Restituzione di proprietà da un gestore di filtri

Le proprietà vengono estratte dagli elementi usando gestori di proprietà registrati o usando filtri registrati per tipi di file specifici. Un gestore di filtri (un'implementazione dell'interfaccia IFilter ) può interpretare il contenuto di un tipo di file in qualsiasi numero di modi.

Questo argomento è organizzato come segue:

Filtro delle proprietà

Le procedure consigliate per il filtro delle proprietà sono elencate nella tabella seguente.

Metodo Descrizione
IFilter::Init Restituisce l'enumerazione IFILTER_FLAGS . Se il membro IFILTER_FLAGS_OLE_PROPERTIES di questa enumerazione è impostato su uno, Windows Search usa le interfacce IPropertySetStorage e IPropertyStorage per enumerare e accedere alle proprietà del tipo di valore esterno.
IFilter::GetChunk Restituisce informazioni da un documento in "blocchi" con tipo di blocco (testo o valore), nome e impostazioni locali. Un blocco contiene una proprietà del documento.
IFilter::GetText Ottiene una proprietà di tipo testo da un blocco.
IFilter::GetValue Ottiene una proprietà di tipo valore da un blocco.

La figura seguente mostra un documento di esempio. La proprietà del tipo di valore esterno (ottenuta usando metodi delle interfacce IPropertySetStorage e IPropertyStorage) e la proprietà BookDocTitle del tipo di valore interno (ottenuta come risultato di un'implementazione IFilter personalizzata) descrivono il documento nel suo complesso. Le proprietà Contents del tipo di testo e Chapter descrivono il contenuto del documento. Durante l'elaborazione di questo documento, il gestore del filtro (un'implementazione dell'interfaccia IFilter ) identifica ed estrae queste proprietà.

diagramma che mostra gli elementi di un documento tipico

Limitazioni delle dimensioni delle proprietà

Esistono due potenziali limitazioni alle dimensioni delle proprietà:

  • Dimensioni massime dei dati accettati da Windows Search per file.
  • Dimensione massima per proprietà definita nel file di descrizione della proprietà.

Attualmente, Windows Search non usa le dimensioni della proprietà definite quando si calcola la quantità di dati accetta da un elemento. Al contrario, il limite usato da Windows Search è il prodotto delle dimensioni del file e della MaxGrowFactor (dimensione del file N * MaxGrowFactor) letti dal Registro di sistema. Il valore predefinito MaxGrowFactor è quattro.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         Gathering Manager
            MaxGrowFactor

Di conseguenza, se il tipo di file tende a essere ridotto in dimensioni totali, ma con proprietà più grandi, Windows Search potrebbe non accettare tutti i dati delle proprietà da generare. Tuttavia, è possibile aumentare l'oggetto MaxGrowFactor in base alle proprie esigenze.

Risorse aggiuntive

Sviluppo di gestori di filtri

Informazioni sui gestori di filtri in Windows Search

Procedure consigliate per la creazione di gestori di filtri in Windows Search

Gestori di filtri che vengono forniti con Windows

Implementazione dei gestori di filtri in Windows Search

Registrazione dei gestori di filtri

Test dei gestori di filtri