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
);

Parameters

  • poszFilter [in]
    A match to a particular URL type.

  • dwFlags [in]
    The IUrlHistory Flags that control how the STATURL structure is filled.

Return value

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

Remarks

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.

Requirements

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

See also

IEnumSTATURL