IShellFolderSearchable::InvalidateSearch-Methode

Dieser Zeiger auf eine Elementbezeichnerliste (Item Identifier List, PIDL) ist ein ungültiger Teil des Shell-Ordners.

Syntax

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

Parameter

pidlSearch [in]

Typ: LPCITEMIDLIST

Ein Zeiger auf die ITEMIDLIST-Struktur für den Suchordner.

pdwFlags [in]

Typ: DWORD*

Derzeit sind keine Flags definiert. auf NULL festgelegt.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Wenn ein Suchordner ungültig ist, kann er eine Bereinigung aller ressourcen durchführen, die er verwendet hat. Die IShellFolderSearchable::InvalidateSearch-Methode kann dazu führen, dass eine asynchrone Suche abgebrochen wird, und führt zu der letztendlichen Freigabe des IShellFolderSearchableCallback-Schnittstellenobjekts .

Anforderungen