Metodo IFilter::GetChunk (filter.h)

  • Articolo

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.

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.

Sintassi

SCODE GetChunk(
  [out] STAT_CHUNK *pStat
);

Parametri

[out] pStat

Puntatore a una struttura STAT_CHUNK contenente una descrizione del blocco corrente.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
 L'operazione è stata completata correttamente.
FILTER_E_END_OF_CHUNKS
 Il blocco precedente è l'ultimo blocco.
FILTER_E_EMBEDDING_UNAVAILABLE
 Il blocco successivo è un incorporamento e non è disponibile alcun filtro di contenuto.
FILTER_E_LINK_UNAVAILABLE
 Il blocco successivo è un collegamento e non è disponibile alcun filtro di contenuto.
FILTER_E_PASSWORD
 Password o altri errori di accesso correlati alla sicurezza.
FILTER_E_ACCESS
Errore di accesso generale.

Commenti

Se al momento della restituzione di pStat punta a una struttura STAT_CHUNK con il membro breakType uguale a CHUNK_NO_BREAK, solo il membro idChunk verrà aggiornato con il nuovo valore idnk identifier (ID). Gli altri membri della struttura STAT_CHUNK rimangono invariati.

Le proprietà di tipo valore interno (blocchi con un valore di enumerazione CHUNKSTATE di CHUNK_VALUE) non possono essere concatenate usando CHUNK_NO_BREAK. Una singola parola non può estendersi a più di due blocchi incollati.

L'ID blocco zero non è valido.

Prima che il metodo GetChunk venga chiamato per la prima volta, non è presente alcun blocco corrente. Dopo che un errore restituisce codice diverso da FILTER_E_END_OF_CHUNKS la chiamata successiva al metodo GetChunk recupera tuttavia il blocco successivo dopo quello non disponibile.

Note ai chiamanti

Al termine del metodo GetChunk , il blocco descritto in *pStat è il blocco corrente. Il descrittore di blocco è di proprietà della routine che chiama il metodo GetChunk , ma il puntatore del nome della proprietà, che può essere impostato nella specifica della proprietà, è di proprietà del metodo GetChunk e non deve essere liberato.

Note per gli implementatori

Se una chiamata al metodo GetChunk del filtro contenuto di un oggetto collegato o incorporato restituisce FILTER_E_END_OF_CHUNKS, l'implementazione deve restituire il blocco successivo dell'oggetto di collegamento o incorporamento. Ad esempio, se un documento ha due oggetti incorporati e il primo ha restituito FILTER_E_END_OF_CHUNKS, il filtro contenuto esterno deve chiamare il metodo GetChunk del filtro contenuto per l'oggetto incorporato.

Prima di restituire i risultati di una chiamata al metodo GetChunk su un oggetto incorporato o collegato, verificare che l'ID blocco sia univoco. In caso contrario, l'implementatore deve rinumerare il blocco e mantenere un mapping del nuovo ID blocco.

Requisiti

   
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

Ifilter

STAT_CHUNK