如何获取与清除IE历史记录

来源:互联网 发布:财新网数据新闻 编辑:程序博客网 时间:2024/05/22 08:02
一、 主要用到了COM组件提供的接口实现,几个接口包括:
1、IUrlHistoryStg、IUrlHistoryStg2(IUrlHistoryStg2接口继承自IUrlHistoryStg)
2、IEnumSTATURL
下面接口信息摘自MSDN
IUrlHistoryStg Interface

This interface manages Microsoft Internet Explorer history for the current user.

IUrlHistoryStg Members

AddUrlPlaces 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.BindToObjectNot currently implemented.DeleteUrlDeletes all instances of the specified URL from the history.EnumUrlsReturns an interface to an enumerator of the history's visited links.QueryUrlQueries the history and reports whether the URL passed as the pocsUrlparameter has been visited by the current user.

Interface Information

Stock Implementationshdocvw.dllCustom ImplementationNoInherits fromIUnknownHeader and IDL filesurlhist.hurlhist.idlMinimum availabilityInternet Explorer 5.5Minimum operating systemsMillennium, Windows 2000
IUrlHistoryStg2 Interface

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

IUrlHistoryStg2 Members

AddUrlAndNotifyProvides an advanced method of adding a URL to the history.ClearHistoryClears history on a per-user basis.

Interface Information

Stock Implementationshdocvw.dllCustom ImplementationNoInherits fromIUrlHistoryStgHeader and IDL filesurlhist.hurlhist.idlMinimum availabilityInternet Explorer 5.5Minimum operating systemsMillennium, Windows 2000
IEnumSTATURL Interface

This interface enumerates the items in the history cache.

IEnumSTATURL Members

CloneNot currently implemented.NextSearches the history for any URL that matches the search pattern and copies it to the specified buffer.ResetResets the enumerator interface so that it begins enumerating at the beginning of the history.SetFilterIEnumSTATURL::Next compares the specified URL with each URL in the history list to find matches. IEnumSTATURL::Next then copies the list of matches to a buffer. This method is used to specify the URL to compare.SkipNot currently implemented.

Interface Information

Stock Implementationshdocvw.dllCustom ImplementationNoInherits fromIUnknownHeader and IDL filesurlhist.hurlhist.idlMinimum availabilityInternet Explorer 5.5Minimum operating systemsMillennium, Windows 2000

二、用到的接口中的相关方法:
1、IUrlHistoryStg::EnumUrls

IUrlHistoryStg::EnumUrls Method
        Returns an 
interface to an enumerator of the history's visited links. 
Syntax
        HRESULT EnumUrls( IEnumSTATURL 
**ppEnum);
Parameters
        ppEnum :[
out] Pointer that receives a pointer to the interface to a history enumerator. 
Return Value
        Returns S_OK 
if successful, or an error value otherwise. 

2、IEnumSTATURL::Next

LRESULT IEnumSTATURL::Next(ULONG celt, LPSTATURL rgelt, ULONG *pceltFetched)
      参数说明:
       celt          意义不明,不能为0,可以将其设为1。
       Rgelt       是STATURL结构指针,该结构由MS
-IE填充。
       PceltFetched 由方法返回,返回1表示rgelt结构被成功填充了。若要用到第二参数内的数据,应该判断该值是否为1。

其中结构STATURL定义如下

STATURL Structure
Contains statistics about a URL. This structure 
is filled by Microsoft Internet Explorer during calls to IUrlHistoryStg::QueryUrl and IEnumSTATURL::Next. 

Syntax

typedef 
struct _STATURL ...{
    DWORD cbSize;
    LPWSTR pwcsUrl;
    LPWSTR pwcsTitle;
    FILETIME ftLastVisited;
    FILETIME ftLastUpdated;
    FILETIME ftExpires;
    DWORD dwFlags;
} STATURL, 
*LPSTATURL;

Members

cbSize 
DWORD that should be 
set to sizeof(STATURL). 
pwcsUrl 
The specified URL.The calling function must free 
this parameter. Set this parameter to STATURL_QUERYFLAG_NOURL if no URL is specified. 
pwcsTitle 
The title of the Web page, 
as contained in the title tags. This calling application must free this parameter. Set this parameter to STATURL_QUERYFLAG_NOTITLE if no Web page is specified. 
ftLastVisited 
The last time the user visited 
this page. 
ftLastUpdated 
The last time the page was updated. 
ftExpires 
The expiry date of the Web page
's content. 
dwFlags 
DWORD that can be either STATURL_QUERYFLAG_ISCACHED or STATURL_QUERYFLAG_TOPLEVEL.

三、代码实现(VC6.0+Windows XP) 

#include <stdio.h>
#include 
<windows.h>
#include 
<UrlHist.h>  // IUrlHistoryStg2 
#include <shlobj.h>   // CLSID_CUrlHistory, SHAddToRecentDocs
#include <atlbase.h>  // USES_CONVERSION;

void GetIEHistory()
...
{
    USES_CONVERSION;
//Unicode转Ansi用
    CoInitialize(NULL); //初始化

    IUrlHistoryStg2
* pUrlHistoryStg2 = NULL;
    HRESULT hr 
= CoCreateInstance(CLSID_CUrlHistory,
        NULL, CLSCTX_INPROC, IID_IUrlHistoryStg2,
        (
void**)&pUrlHistoryStg2);

    
/**//*if (SUCCEEDED(hr))
    {
        hr = pUrlHistoryStg2->ClearHistory();
        pUrlHistoryStg2->Release();
    }
*/


    IEnumSTATURL
* pEnumURL;
    hr 
= pUrlHistoryStg2->EnumUrls(&pEnumURL);

    STATURL suURL;
    ULONG pceltFetched;
    suURL.cbSize 
= sizeof(suURL);
    hr 
= pEnumURL->Reset();

    
while((hr = pEnumURL->Next(1&suURL, &pceltFetched)) == S_OK)
    ...
{
        
//hr = pUrlHistoryStg2->DeleteUrl(suURL.pwcsUrl, 0);
        printf("%s ", W2T(suURL.pwcsUrl));
    }


    pEnumURL
->Release();
    pUrlHistoryStg2
->Release();
    CoUninitialize();
}