Metode ILoadFilter::LoadIFilter (filtereg.h)

Artikel
02/27/2024

Mengambil dan memuat filter yang paling tepat yang dipetakan ke sumber data Shell.

Sintaks

HRESULT LoadIFilter(
  [in]      LPCWSTR               pwcsPath,
  [in]      FILTERED_DATA_SOURCES *pFilteredSources,
  [in]      IUnknown              *pUnkOuter,
  [in]      BOOL                  fUseDefault,
  [in, out] CLSID                 *pFilterClsid,
  [in, out] int                   *SearchDecSize,
  [in, out] WCHAR                 **pwcsSearchDesc,
  [in, out] IFilter               **ppIFilt
);

Parameter

[in] pwcsPath

Penunjuk ke buffer string Unicode yang dipisahkan koma yang dihentikan null yang menentukan jalur file yang akan difilter. Parameter ini dapat berupa null.

[in] pFilteredSources

Penunjuk ke struktur FILTERED_DATA_SOURCES yang menentukan parameter untuk sumber data Shell tempat filter dimuat. Parameter ini tidak boleh null.

[in] pUnkOuter

Jika objek sedang dibuat sebagai bagian dari agregat, tentukan penunjuk ke antarmuka IUnknown pengontrol agregat.

[in] fUseDefault

Jika TRUE, gunakan filter default; jika FALSE, lanjutkan dengan filter yang paling tepat yang tersedia.

[in, out] pFilterClsid

Penunjuk ke CLSID (CLSID_FilterRegistration) yang menerima pengidentifikasi kelas filter yang dikembalikan.

[in, out] SearchDecSize

Tidak diterapkan.

[in, out] pwcsSearchDesc

Tidak diterapkan.

[in, out] ppIFilt

Alamat penunjuk ke implementasi antarmuka IFilter yang dipilih LoadIFilter .

Nilai kembali

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Filter, juga dikenal sebagai handler filter, adalah implementasi antarmuka IFilter .

ILoadFilter mencoba memuat filter yang dapat memproses sumber data Shell dari jenis yang ditentukan dalam parameter pFilteredSources melalui parameter pwcsPath . Jika filter yang sesuai untuk sumber data tidak ditemukan, dan fUseDefaultsalah, metode ini mengembalikan null dalam parameter ppIFilt . Jika filter yang sesuai untuk sumber data tidak ditemukan, dan fUseDefaultbenar, antarmuka IFilter pada IFilter default dikembalikan dalam parameter ppIFilt .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	filtereg.h
Pustaka	SearchSDK.lib (untuk CLSID_FilterRegistration)

Lihat juga

ILoadFilter

Bagikan melalui