AddUrlAndNotify method

Provides an advanced method to add a URL to the Windows Internet Explorer history.


HRESULT retVal = object.AddUrlAndNotify(pocsUrl, pocsTitle, dwFlags, fWriteHistory, poctNotify, punkISFolder);


  • pocsUrl [in]

    The URL to place in the history.

  • pocsTitle [in]

    A pointer to a variable of type LPCOLESTR that specifies the title for this URL. If NULL, no title is added.

  • dwFlags [in]
    Type: DWORD

    Not implemented.

  • fWriteHistory [in]
    Type: BOOL

    A BOOL that enables writing to the date-history containers. TRUE enables writing to the date-history containers. FALSE disables writing to the date-history containers.

  • poctNotify [in]
    Type: IOleCommandTarget

    If fWriteHistory is set to TRUE, the Exec method of the IOleCommandTarget interface is called and passed the CGID_Explorer flag, the SBCMDID_SELECTHISTPIDL flag, and the OLECMDEXECOPT_PROMPTUSER flag, with a variant that contains the appropriate PIDL.

  • punkISFolder [in]
    Type: IUnknown

    The history Shell folder where the date containers are stored. If a location is not provided, the default location is used. In most cases, the calling function should specify null.

Return value


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