IFilter::Metode GetValue (filter.h)

  • Artikel

Catatan

Layanan Pengindeksan tidak lagi didukung pada Windows XP dan tidak tersedia untuk digunakan pada Windows 8. Sebagai gantinya, gunakan Windows Search untuk pencarian sisi klien dan Microsoft Search Server Express untuk pencarian sisi server.

Mengambil nilai (properti jenis nilai internal) dari gugus, yang harus memiliki nilai enumerasi CHUNKSTATE CHUNK_VALUE.

Sintaks

SCODE GetValue(
  [out] PROPVARIANT **ppPropValue
);

Parameter

[out] ppPropValue

Penunjuk ke variabel output yang menerima penunjuk ke struktur PROPVARIANT yang berisi properti jenis nilai.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK
 Operasi berhasil diselesaikan.
FILTER_E_NO_MORE_VALUES
Metode GetValue telah dipanggil pada gugus ini; nilai ini harus dikembalikan sampai metode IFilter::GetChunk berhasil dipanggil dan telah maju ke gugus berikutnya.
FILTER_E_NO_VALUES
 Gugus saat ini tidak memiliki nilai enumerasi CHUNKSTATE CHUNK_VALUE.

Keterangan

Panggil metode GetValue hanya sekali per gugus.

Perhatikan bahwa efek menghasilkan nilai yang sama dari lebih dari satu gugus tidak ditentukan. Hanya pengaturan terakhir dari nilai yang valid.

Catatan untuk Penelepon

Alokasikan struktur PROPVARIANT dengan CoTaskMemAlloc. Beberapa struktur PROPVARIANT berisi pointer, yang dapat dikosongkan dengan memanggil fungsi PropVariantClear . Terserah pemanggil metode GetValue untuk memanggil PropVariantClear.

Persyaratan

   
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header filter.h

Lihat juga

IFilter