Metodo IFilter::GetValue (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.

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
S_OK
 L'operazione è stata completata correttamente.
FILTER_E_NO_MORE_VALUES
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.
FILTER_E_NO_VALUES
 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

Vedi anche

Ifilter