次の方法で共有

ILoadFilter::LoadIFilter メソッド (filtereg.h)

  • [アーティクル]

シェル データ ソースにマップされている最も適切なフィルターを取得して読み込みます。

構文

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構造体へのポインター。 このパラメーターは 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 は、 pFilteredSources パラメーターで指定された型のシェル データ ソースを pwcsPath パラメーターを介して処理できるフィルターの読み込みを試みます。データ ソースの適切なフィルターが見つからず、 fUseDefault が false の場合、このメソッドは ppIFilt パラメーターで null を返します。 データ ソースの適切なフィルターが見つからず、fUseDefault が true の場合、既定の IFilter の IFilter インターフェイスが ppIFilt パラメーターで返されます。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー filtereg.h
Library SearchSDK.lib (CLSID_FilterRegistration用)

こちらもご覧ください

ILoadFilter