IEnumSTATURL::SetFilter method

Specifies the URL to compare with each URL in the Windows Internet Explorer history.

Syntax


HRESULT SetFilter(
  [in] LPCOLESTR poszFilter,
  [in] DWORD     dwFlags
);

poszFilter [in]: A match to a particular URL type.
dwFlags [in]: The IUrlHistory Flags that control how the STATURL structure is filled.

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

IEnumSTATURL::SetFilter was introduced in Microsoft Internet Explorer 6.

IEnumSTATURL::Next compares the specified URL with each URL in the history to find matches, and then copies the list of matches to a buffer.

If a filter is specified in the poszFilter parameter, call IEnumSTATURL::Reset after the enumerator is no longer required.

Minimum supported client	Windows XP, Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Product	Internet Explorer 6
Header	Urlhist.h
IDL	Urlhist.idl
DLL	Shdocvw.dll