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 filtro (un'implementazione dell'interfaccia IFilter ) può interpretare il contenuto di un tipo di file in diversi modi.

Questo argomento è organizzato come segue:

Filtro delle proprietà

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

Metodo Description
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à di tipo 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 segmento.

La figura seguente mostra un documento di esempio. La proprietà DocTitle external value-type (ottenuta usando i metodi delle interfacce IPropertySetStorage e IPropertyStorage ) e la proprietà Book interna value-type (ottenuta come risultato di un'implementazione IFilter personalizzata) descrivono il documento nel suo complesso. Le proprietà Contents di tipo testo e Chapter descrivono il contenuto del documento. Durante l'elaborazione di questo documento, il gestore di filtri (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 per le dimensioni delle proprietà:

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

Attualmente, Windows Search non usa le dimensioni della proprietà definite durante il calcolo della quantità di dati accettata da un elemento. Al contrario, il limite usato da Windows Search è il prodotto delle dimensioni del file e la MaxGrowFactor (dimensione del file N * MaxGrowFactor) letta 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 piccolo in termini di dimensioni totali ma ha dimensioni delle proprietà più grandi, Windows Search potrebbe non supportare tutti i dati delle proprietà che si desidera generare. Tuttavia, è possibile aumentare il parametro 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 forniti con Windows

Implementazione di gestori di filtri in Windows Search

Registrazione dei gestori di filtri

Test dei gestori di filtri