Metodo IFilter::GetChunk (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.
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 |
|---|---|
|
L'operazione è stata completata correttamente. |
|
Il blocco precedente è l'ultimo blocco. |
|
Il blocco successivo è un incorporamento e non è disponibile alcun filtro di contenuto. |
|
Il blocco successivo è un collegamento e non è disponibile alcun filtro di contenuto. |
|
Password o altri errori di accesso correlati alla sicurezza. |
|
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 |