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
Reference