IShellFolderSearchable インターフェイス

シェル拡張機能が検索可能な名前空間を提供できるようにするメソッドを公開します。

メンバー

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

• メソッド

メソッド

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

メソッド	説明
CancelAsyncSearch	保留中の非同期検索を取り消すプロセスを開始します。
FindString	指定した検索文字列の検索を開始します。
InvalidateSearch	この PIDL をシェル フォルダーの無効な部分にします。

 

注釈

このインターフェイスは、パブリック ヘッダー ファイルでは定義されていません。 このインターフェイスを実装することを選択した場合は、次の C/C++ コードを使用してそのメソッドを宣言できます。

#undef  INTERFACE
#define INTERFACE IShellFolderSearchable
DECLARE_INTERFACE_IID_(IShellFolderSearchable, IUnknown, "4E1AE66C-204B-11d2-8DB3-0000F87A556C")
{
    // *** IUnknown methods ***
    STDMETHOD(QueryInterface) (THIS_ REFIID riid, __out void **ppv) PURE;
    STDMETHOD_(ULONG,AddRef)  (THIS) PURE;
    STDMETHOD_(ULONG,Release) (THIS) PURE;

    // *** IShellFolderSearchable methods ***

    // FindString -
    //  The returned Shell folder's enumerator will have any
    //   search hits for the given search string.
    //  punkOnAsyncSearch will be QI'd for IShellFolderSearchableCallback
    STDMETHOD(FindString)(THIS_ LPCWSTR pwszTarget, __inout_opt DWORD *pdwFlags,
                          __in_opt IUnknown *punkOnAsyncSearch, __out LPITEMIDLIST *ppidlOut)   PURE;
    // CancelAsyncSearch -
    //   Begins the process of canceling any pending
    //    asynchronous search from this pidl.
    //    When the search is actually canceled, RunEnd will be called
    //   Returns: S_OK => cancelling, S_FALSE => not running
    STDMETHOD(CancelAsyncSearch) (THIS_ LPCITEMIDLIST pidlSearch, __inout_opt DWORD *pdwFlags) PURE;

    // InvalidateSearch -
    //   Makes this pidl no longer a valid portion of the Shell folder
    //    Also does some cleanup of any databases used in the search and
    //    will cause the eventual release of the callback
    //   May cause async search to be canceled
    STDMETHOD(InvalidateSearch)  (THIS_ LPCITEMIDLIST pidlSearch, __inout_opt DWORD *pdwFlags) PURE;
};

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
[DLL]	Shell32.dll