Provides methods to access privacy records for URLs visited.
GetPrivacyImpacted Gets a Boolean value that indicates whether a Web site's attempted cookie actions conflict with the user's privacy settings. GetSize Gets the total number of privacy records. Next Gets the contents of the current privacy record and moves the pointer to the next privacy record. Reset Resets the privacy records pointer to the beginning of the privacy records list.
The privacy records list is reset each time the user initiates a top-level movement to another Web page. Even if the movement is aborted, the privacy records list is reset. When the user performs a top-level movement, the IEnumPrivacyRecords::Reset method must be called before the new set of privacy records is accessed.
User-initiated, top-level Web page movements include the following.
- Typing a URL in the address bar.
- Moving to another Web page by clicking Go To on the View menu.
- Choosing a URL from the Favorites List.
- Clicking a hyperlink that does not contain a script href tag.
- Refreshing the page at the top level.
- Moving to another Web page by clicking the Back button or the Forward button.
Moving between frames or moving to another Web page at the top level using script adds to the existing privacy list instead of resetting it. When the user moves to another Web page at the top level through script, a blank record is inserted before records are added for the new page and its dependent downloads.
The IEnumPrivacyRecords interface can be obtained by using IServiceProvider::QueryService and passing in IID_IEnumPrivacyRecords. The IServiceProvider interface can be obtained by calling QueryInterface through the IWebBrowser2 interface or any of the MSTHML interfaces.
Stock Implementation mshtml.dll Custom Implementation No Inherits from IUnknown Header and IDL files mshtml.h, mshtml.idl Minimum availability Internet Explorer 6 Minimum operating systems Windows 98, Windows NT 4.0