IEnumPrivacyRecords::Next method

Gets the contents of the current privacy record and moves the pointer to the next privacy record.

Syntax

HRESULT Next(
  [out] BSTR      *pbstrUrl,
  [out] BSTR      *pbstrPolicyRef,
        long      *pdwReserved,
  [out] DWORD *pdwFlags
);

Parameters

  • pbstrUrl [out]
    A pointer to a BSTR of the URL to which the current privacy record information applies.

  • pbstrPolicyRef [out]
    A pointer to a BSTR of the URL that contains the privacy policy information for pbstrUrl.

  • pdwReserved
    Reserved. Must be set to null.

  • pdwFlags [out]
    A pointer to a DWORD that combines Privacy Flags that specify the status of privacy agreements and any cookie actions for pbstrUrl.

Return value

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

Remarks

IEnumPrivacyRecords::Next was introduced in Microsoft Internet Explorer 6.

Privacy records are kept for all URLs on a page.

Note Images, stylesheets, script files, and so on, can belong to URLs other than the top-level URL.

Typically, by moving to another Web page at the top-level, the privacy records list is reset. If a top-level movement occurs due to script, the privacy records list is not reset. Instead, a blank record is inserted into the privacy records list before new records are added for URLs associated with the new page. The top-level URL for this new page has the PRIVACY_URLISTOPLEVEL flag set in pdwFlags.

A given URL can have more than one privacy record. All privacy records for a specific URL must be considered to get the complete privacy report for a URL.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 6

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

IEnumPrivacyRecords

Reference

IEnumPrivacyRecords::GetPrivacyImpacted

IEnumPrivacyRecords::GetSize

IEnumPrivacyRecords::Reset