IFilter::Metode init (filter.h)

Artikel
02/28/2024

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.

Menginisialisasi sesi pemfilteran.

Sintaks

SCODE Init(
  [in]  ULONG              grfFlags,
  [in]  ULONG              cAttributes,
  [in]  const FULLPROPSPEC *aAttributes,
  [out] ULONG              *pFlags
);

Parameter

[in] grfFlags

Nilai dari enumerasi IFILTER_INIT untuk mengontrol standardisasi teks, output properti, cakupan penyematan, dan pola akses IFilter .

[in] cAttributes

Ukuran array atribut. Ketika nonzero, cAttributes lebih diutamakan daripada atribut yang ditentukan dalam grfFlags. Jika tidak ada bendera atribut yang ditentukan dan cAttributes adalah nol, defaultnya diberikan oleh kumpulan properti penyimpanan PSGUID_STORAGE, yang berisi tanggal dan waktu penulisan terakhir ke file, ukuran, dan sebagainya; dan dengan properti 'konten' PID_STG_CONTENTS, yang memetakan ke konten utama file. Untuk informasi selengkapnya tentang properti dan kumpulan properti, lihat Kumpulan Properti.

[in] aAttributes

Penunjuk ke array struktur FULLPROPSPEC untuk properti yang diminta. Saat cAttributes bukan nol, hanya properti dalam aAttributes yang dikembalikan.

[out] pFlags

Informasi tentang properti tambahan yang tersedia untuk pemanggil; dari enumerasi IFILTER_FLAGS .

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil diselesaikan.
E_FAIL	File yang akan difilter sebelumnya tidak dimuat.
E_INVALIDARG	Jumlah dan konten atribut tidak setuju.
FILTER_E_PASSWORD	Akses ditolak karena perlindungan kata sandi atau langkah-langkah keamanan serupa.
FILTER_E_ACCESS	Kegagalan akses umum

Keterangan

Metode Init mengatur status objek filter. Filter konten memposisikan di awal objek dan status objek dibekukan hingga objek dilepaskan. Anda dapat meneruskan objek filter kumpulan properti yang ingin Anda kembalikan dengan menyiapkan kumpulan properti dan deskripsi pengidentifikasi properti (ID) mereka di array aAttributes . Untuk informasi selengkapnya, lihat Memfilter Properti File.

Catatan untuk Penelepon

Panggil metode Init sebelum memanggil semua metode IFilter lainnya.

Catatan untuk Pelaksana

ID gugus harus tetap konsisten di beberapa panggilan ke metode Init dengan parameter yang sama.

Untuk beberapa implementasi antarmuka IFilter , deteksi kegagalan untuk mengakses dokumen mungkin tidak dimungkinkan (atau mungkin mahal secara komputasi) sampai metode Init telah dipanggil, atau bahkan mungkin nanti.

Persyaratan

Persyaratan	Nilai
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