IProtocolHandlerSite：：GetFilter 方法 (searchapi.h)

根據提供的參數擷取適當的 IFilter 。

語法

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

參數

[in] pclsidObj

類型： CLSID*

從登錄中檔類型的CLSID指標。 這可用於內嵌文件的專案，以指出要用於該內嵌文件的適當 IFilter 。

[in] pcwszContentType

類型： LPCWSTR

包含文件類型的 Null 終止 Unicode 字串指標。 這可用來擷取根據MIME類型對應的IFilter。

[in] pcwszExtension

類型： LPCWSTR

包含擴展名的 Null 終止 Unicode 字串指標，不含前一個句點。 這是用來擷取根據擴展名所對應的 IFilter 物件。

[out] ppFilter

類型： IFilter**

接收通訊協議處理程式所使用的 IFilter 指標位址。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

這個方法會查詢篩選主機，以識別要用於URL專案的適當 IFilter 物件。

篩選的選擇是以擴展名、CLSID 為基礎，可識別登錄中的檔案內容類型，或MIME內容類型。 您必須只提供這個方法的三個參數之一。 如果您提供多個參數，則會依下列順序進行測試： pcwszContentType、 pclsidObj、 pcwszExtension。 第一個有效參數是用來選取適當的 IFilter;其他專案會被忽略。

規格需求

需求	值
最低支援的用戶端	Windows XP 搭配 SP2、Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台	Windows
標頭	searchapi.h
可轉散發套件	Windows 桌面搜尋 (WDS) 3.0