Metodo IFilter::GetValue (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.
Recupera un valore (proprietà di tipo valore interno) da un blocco, che deve avere un valore di enumerazione CHUNKSTATE di CHUNK_VALUE.
Sintassi
SCODE GetValue(
[out] PROPVARIANT **ppPropValue
);
Parametri
[out] ppPropValue
Puntatore a una variabile di output che riceve un puntatore alla struttura PROPVARIANT che contiene la proprietà value-type.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
L'operazione è stata completata correttamente. |
|
Il metodo GetValue è già stato chiamato in questo blocco; questo valore deve essere restituito fino a quando il metodo IFilter::GetChunk non viene chiamato correttamente e ha eseguito il passaggio avanzato al blocco successivo. |
|
Il blocco corrente non ha un valore di enumerazione CHUNKSTATE pari a CHUNK_VALUE. |
Commenti
Chiamare il metodo GetValue una sola volta per blocco.
Si noti che l'effetto della produzione dello stesso valore da più blocchi non è definito. Solo l'ultima impostazione del valore è valida.
Note ai chiamanti
Allocare la struttura PROPVARIANT con CoTaskMemAlloc. Alcune strutture PROPVARIANT contengono puntatori, che possono essere liberati chiamando la funzione PropVariantClear . Spetta al chiamante del metodo GetValue chiamare PropVariantClear.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 |