IFolderFilterSite インターフェイス (shobjidl_core.h)

  • [アーティクル]

クライアントがシェル フォルダー列挙をフィルター処理する方法を指定できるように、ホストによってエクスポートされます。

継承

IFolderFilterSite インターフェイスは、IUnknown インターフェイスから継承します。 IFolderFilterSite には、次の種類のメンバーもあります。

メソッド

IFolderFilterSite インターフェイスには、これらのメソッドがあります。

 
IFolderFilterSite::SetFilter

クライアントがホストに IUnknown インターフェイス ポインターを渡せるように、ホストによって公開されます。

解説

このインターフェイスの最も一般的な用途は、アプリケーションが SHBrowseForFolder を呼び出すときです。 この関数を呼び出すと、フォルダー ブラウザー オブジェクトのクライアントになります。 そのオブジェクトは、コールバック関数 BrowseCallbackProc にメッセージを送信することで、ユーザーと通信します。 BFFM_IUNKNOWN メッセージには、フォルダー ブラウザーの IUnknown インターフェイスへのポインターが含まれています。 フォルダー列挙をフィルター処理するには:

  1. フォルダー ブラウザーの QueryInterface メソッドを呼び出し、IFolderFilterSite インターフェイスへのポインターを要求するには、IUnknown ポインターを使用します。
  2. IFolderFilterSite::SetFilter を呼び出し、フォルダー ブラウザーに IFolderFilter (IUnknown または IFilterFolder?) インターフェイスへのポインターを渡します。
  3. その後、フォルダー ブラウザーは IFolderFilterSite インターフェイスの 2 つのメソッドに対してクエリを実行して、列挙をフィルター処理する方法を決定します。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)