Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function retrieves the privacy settings for a given URLZONEand PrivacyType.

Syntax 

DWORD PrivacyGetZonePreferenceW(
  DWORD dwZone,
  DWORD 
dwType,
  DWORD 
dwTemplate,
  LPCWSTR 
pszPreference,
);

Parameters

dwZone

[in] Value of type DWORD that specifies the URLZONEfor which privacy settings are being retrieved.

dwType

[in] Value of type DWORD that specifies the PrivacyType for which privacy settings are being retrieved. For more information about PrivacyTYpe flags to specify, see Privacy Flags.

dwTemplate

[out] LPDWORD that returns a pointer to a DWORD containing which of the PrivacyTemplates is in use for this dwZoneand dwType. For more information about PrivacyTemplates flags to specify, see Privacy Flags.

pszPreference

[in] If dwTemplateis set to PRIVACY_TEMPLATE_CUSTOM, this parameter is the string representation of the custom preferences. Otherwise, it is ignored. A description of this string representation is included in the Remarks section.

Return Value

Returns zero if successful. Otherwise, one of the errors defined in winerr.h is returned.

Remarks

These privacy settings for the Internet zone are found on the Privacy tab of the Internet Options dialog box.

Setting the privacy options for the URLZONE_INTERNET involves setting the PrivacyTemplates for both PrivacyTypes. The slider on the Privacy Menu in Internet Options only moves if privacy is set for both PrivacyTypes.

Custom privacy preferences for a given URLZONEand PrivacyType can be set through the pszPreferenceparameter. This parameter can contain a series of rules, separated by white space, that describe the privacy preferences. It is important to note that the rules themselves cannot contain white space. pszPreferencehas the following structure where there can be multiple logical rules.

Copy Code 
<signature> <logical-rule> <special-rule>

Currently, the signature must be set to IE6-P3PSettings/V1:.

Logical rules have the following format.

Copy Code 
/<expression>=<decision>/

An expression is a Boolean statement composed of compact policy tokens that use the operators & (logical AND) and ! (logical NOT). The compact policy token is case-sensitive. For more information about Platform for Privacy Preferences (P3P) privacy policies and compact policy tokens, see the Platform for Privacy Preferences (P3P) Project specificationat this official W3C Web site.

For more information, see Privacy Templates.

Logical rules are evaluated in the order they are listed. The first logical-rule to be matched, if any, determines the cookie action.

An empty expression is also allowed. If an expression is empty, the left-hand side evaluates to true. This form of a logical-rule can be used at the end of a set of rules to catch all situations that did not fall into the other categories.

The following example code shows the valid logical rules.

Copy Code 
/DEM=d/
	Deny a cookie whose compact policy contains the DEM token
/CON&!TEL=a/   
	Accept a cookie whose compact policy contains the CON token 
	and does not contain the TEL token
/=a/
	Accept all cookies

The following example shows a privacy preferences string that specifies accepting cookies for which the compact policy contains a FIN/CONi token pair, reject cookies with compact policies containing FIN/CON, FIN/CONo, FIN/CONa and GOV/PUB token pairs or a TEL token, and to prompt the user when a cookie's compact policy contains the UNR token. It also specifies to downgrade cookies without a compact policy to session cookies and to accept all cookies that do not match one of the given rules. Note that the first rule that evaluates to true determines the cookie action.

Copy Code 
IE6-P3PSettings/V1: /FIN&CONi=a/ /FIN&CONo=r/
/FIN&CONa=r/ /FIN&CON=r/ 
/GOV&PUB=r/ /TEL=r/ /UNR=p/ nopolicy=d /=a/

Requirements

Header wininet.h
Library wininet.lib
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also