다음을 통해 공유


IShellFolderSearchable 인터페이스

셸 확장이 검색 가능한 네임스페이스를 제공할 수 있도록 하는 메서드를 노출합니다.

멤버

IShellFolderSearchable 인터페이스는 IUnknown 인터페이스에서 상속됩니다. IShellFolderSearchable 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IShellFolderSearchable 인터페이스에는 이러한 메서드가 있습니다.

메서드 설명
CancelAsyncSearch 보류 중인 비동기 검색을 취소하는 프로세스를 시작합니다.
Findstring 지정된 검색 문자열에 대한 검색을 시작합니다.
InvalidateSearch 이 PIDL을 Shell 폴더의 잘못된 부분으로 만듭니다.

 

설명

이 인터페이스는 공용 헤더 파일에 정의되어 있지 않습니다. 이 인터페이스를 구현하도록 선택하는 경우 다음 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