IUrlHistoryStg2  Interface

IID_IUrlHistoryStg2

{AFA0DC11-C313-11D0-831A-00C04FD5AE38}

This interface provides additional features for managing the user's history.

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IUrlHistoryStg Methods

Description

AddUrl

Places the specified URL into the history. If the URL does not exist in the history, an entry is created in the history. If the URL does exist in the history, it is overwritten.

DeleteUrl

Deletes all instances of the specified URL from the history.

QueryUrl

Queries the history and reports whether the URL passed as the pocsUrl parameter has been visited by the current user.

BindToObject

Not currently implemented.

EnumUrls

Returns an interface to an enumerator of the history's visited links.

IUrlHistoryStg2 Methods

Description

AddUrlAndNotify

Provides an advanced method of adding a URL to the history.

ClearHistory

Clears history on a per-user basis.

AddUrl

FUNCTION IUrlHistoryStg2_AddUrl ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL strUrl AS STRING _
, BYVAL strTitle AS STRING _
, BYVAL dwFlags AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  strUrl = UCODE$(strUrl) & $NUL
  strTitle = UCODE$(strTitle) & $NUL
  CALL DWORD @@pthis[3] USING IUrlHistoryStg2_AddUrl (pthis, strUrl, strTitle, dwFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

DeleteUrl

FUNCTION IUrlHistoryStg2_DeleteUrl ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL strUrl AS STRING _
, BYVAL dwFlags AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  strUrl = UCODE$(strUrl) & $NUL
  CALL DWORD @@pthis[4] USING IUrlHistoryStg2_DeleteUrl (pthis, strUrl, dwFlags) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

QueryUrl

FUNCTION IUrlHistoryStg2_QueryUrl ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL strUrl AS STRING _
, BYVAL dwFlags AS DWORD _
, BYREF lpSTATURL AS STATURL _
  ) AS LONG

  LOCAL HRESULT AS LONG

  strUrl = UCODE$(strUrl) & $NUL
  CALL DWORD @@pthis[5] USING IUrlHistoryStg2_QueryUrl (pthis, strUrl, dwFlags, lpSTATURL) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

BindToObject

FUNCTION IUrlHistoryStg2_BindToObject ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL strUrl AS STRING _
, BYREF riid AS GUID _
, BYREF ppvOut AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  strUrl = UCODE$(strUrl) & $NUL
  CALL DWORD @@pthis[6] USING IUrlHistoryStg2_BindToObject (pthis, strUrl, riid, ppvOut) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

EnumUrls

FUNCTION IUrlHistoryStg2_EnumUrls ( _
  BYVAL pthis AS DWORD PTR _
, BYREF ppEnum AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[7] USING IUrlHistoryStg2_EnumUrls (pthis, ppEnum) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

AddUrlAndNotify

FUNCTION IUrlHistoryStg2_AddUrlAndNotify ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL strUrl AS STRING _
, BYVAL strTitle AS STRING _
, BYVAL dwFlags AS DWORD _
, BYVAL fWriteHistory AS LONG _
, BYVAL poctNotify AS DWORD _
, BYVAL punkISFolder AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  strUrl = UCODE$(strUrl) & $NUL
  CALL DWORD @@pthis[8] USING IUrlHistoryStg2_AddUrlAndNotify (pthis, strUrl, strTitle, dwFlags, fWriteHistory, poctNotify, punkISFolder) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

ClearHistory

FUNCTION IUrlHistoryStg2_ClearHistory ( _
  BYVAL pthis AS DWORD PTR _
  ) AS LONG

  LOCAL HRESULT AS LONG

  CALL DWORD @@pthis[9] USING IUrlHistoryStg2_ClearHistory (pthis) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION