ILoadFilter：：LoadIFilter 方法 (filtereg.h)

  • 發行項

擷取並載入對應至Shell數據源的最適當篩選。

語法

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
);

參數

[in] pwcsPath

以逗號分隔的 Null 終止 Unicode 字串緩衝區指標，指定要篩選的檔案路徑。 此參數可以是 null。

[in] pFilteredSources

FILTERED_DATA_SOURCES結構的指標，指定載入篩選條件之Shell數據源的參數。 這個參數不可以是 Null。

[in] pUnkOuter

如果要建立物件做為匯總的一部分，請指定匯總之控制 IUnknown 介面的指標。

[in] fUseDefault

如果 為 TRUE，請使用預設篩選條件;如果 為 FALSE，請繼續進行最適當的可用篩選。

[in, out] pFilterClsid

接收所傳回篩選條件類別標識碼的CLSID (CLSID_FilterRegistration) 指標。

[in, out] SearchDecSize

未實作。

[in, out] pwcsSearchDesc

未實作。

[in, out] ppIFilt

LoadIFilter 所選取之 IFilter 介面實作的指標位址。

傳回值

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

備註

篩選也稱為篩選處理程式，是 IFilter 介面的實作。

ILoadFilter 會嘗試載入篩選條件，以透過 pwcsPath 參數處理 pFilteredSources 參數中所指定類型的 Shell 數據源。如果找不到數據源的適當篩選，且 fUseDefault 為 false，這個方法會在 ppIFilt 參數中傳回 null。 如果找不到數據源的適當篩選，且 fUseDefault 為 true，則會在 ppIFilt 參數中傳回預設 IFilter 上的 IFilter 介面。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 filtereg.h
程式庫 CLSID_FilterRegistration) 的 SearchSDK.lib (

另請參閱

ILoadFilter