IProtocolHandlerSite::Metode GetFilter (searchapi.h)

Mengambil IFilter yang sesuai sesuai dengan parameter yang disediakan.

Sintaks

HRESULT GetFilter(
  [in]  CLSID   *pclsidObj,
  [in]  LPCWSTR pcwszContentType,
  [in]  LPCWSTR pcwszExtension,
  [out] IFilter **ppFilter
);

Parameter

[in] pclsidObj

Jenis: CLSID*

Arahkan ke CLSID jenis dokumen dari registri. Ini digunakan untuk item dengan dokumen yang disematkan untuk menunjukkan IFilter yang sesuai untuk digunakan untuk dokumen yang disematkan tersebut.

[in] pcwszContentType

Jenis: LPCWSTR

Penunjuk ke string Unicode yang dihentikan null yang berisi jenis dokumen. Ini digunakan untuk mengambil IFilters yang dipetakan sesuai dengan jenis MIME.

[in] pcwszExtension

Jenis: LPCWSTR

Penunjuk ke string Unicode yang dihentikan null yang berisi ekstensi nama file, tanpa periode sebelumnya. Ini digunakan untuk mengambil objek IFilter yang dipetakan sesuai dengan ekstensi nama file.

[out] ppFilter

Jenis: IFilter**

Menerima alamat pointer ke IFilter yang digunakan penangan protokol.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Metode ini meminta Filter Host untuk mengidentifikasi objek IFilter yang sesuai untuk digunakan untuk item URL.

Pilihan filter didasarkan pada ekstensi nama file, CLSID yang mengidentifikasi jenis konten file di registri, atau pada jenis konten MIME. Anda hanya perlu menyediakan salah satu dari tiga parameter untuk metode ini. Jika Anda menyediakan beberapa parameter, parameter tersebut diuji dalam urutan berikut: pcwszContentType, pclsidObj, pcwszExtension. Parameter valid pertama digunakan untuk memilih IFilter yang sesuai; yang lain diabaikan.

Persyaratan