Método IShellFolderSearchable::InvalidateSearch

Torna esse ponteiro para uma PIDL (lista de identificadores de item) uma parte inválida da pasta Shell.

Sintaxe

HRESULT InvalidateSearch(
  [in] LPCITEMIDLIST pidlSearch,
  [in] DWORD         *pdwFlags
);

Parâmetros

pidlSearch [in]

Tipo: LPCITEMIDLIST

Um ponteiro para a estrutura ITEMIDLIST para a pasta de pesquisa.

pdwFlags [in]

Tipo: DWORD*

Nenhum sinalizador está definido no momento; defina como NULL.

Valor retornado

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

Quando uma pasta de pesquisa é invalidada, ela pode executar a limpeza de todos os recursos usados. O método IShellFolderSearchable::InvalidateSearch pode fazer com que uma pesquisa assíncrona seja cancelada e resultará na versão eventual do objeto de interface IShellFolderSearchableCallback .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
DLL	Shell32.dll