Partager via


PrivacySetZonePreferenceW, fonction (winineti.h)

Définit les paramètres de confidentialité d’une URLZONE et d’un PrivacyType donnés.

Syntaxe

DWORD PrivacySetZonePreferenceW(
  [in]           DWORD   dwZone,
  [in]           DWORD   dwType,
  [in]           DWORD   dwTemplate,
  [in, optional] LPCWSTR pszPreference
);

Paramètres

[in] dwZone

Valeur de type DWORD qui spécifie l’URLZONE pour laquelle les paramètres de confidentialité sont définis.

[in] dwType

Valeur de type DWORD qui spécifie le PrivacyType pour lequel les paramètres de confidentialité sont définis.

[in] dwTemplate

Valeur de type DWORD qui spécifie les modèles de confidentialité à utiliser pour définir les paramètres de confidentialité.

[in, optional] pszPreference

Si dwTemplate a la valeur PRIVACY_TEMPLATE_CUSTOM, ce paramètre est la représentation sous forme de chaîne des préférences personnalisées. Sinon, elle doit être définie sur NULL. Une description de cette représentation sous forme de chaîne est incluse dans la section Remarques.

Valeur retournée

Retourne zéro si l’opération réussit. Sinon, l’une des erreurs définies dans winerr.h est retournée.

Remarques

Ces paramètres de confidentialité pour la zone Internet se trouvent sous l’onglet Confidentialité de la boîte de dialogue Options Internet .

La définition des options de confidentialité pour le URLZONE_INTERNET implique de définir les modèles de confidentialité pour les deux Types de confidentialité. Le curseur du menu Confidentialité dans Options Internet ne se déplace que si la confidentialité est définie pour les deux PrivacyTypes.

Les préférences de confidentialité personnalisées pour une URLZONE et un PrivacyType donnés peuvent être définies via le paramètre pszPreference . Le paramètre pszPreference peut contenir une série de règles séparées par des espaces blancs décrivant les préférences de confidentialité. Il est important de noter que les règles elles-mêmes ne peuvent pas contenir d’espace blanc. PszPreference a la structure suivante où il peut y avoir plusieurs règles logiques : <signature><logical-rule><special-rule>.

Actuellement, la signature doit être définie sur IE6-P3PSettings/V1 :.

Les règles logiques ont le format suivant : /<expression>=<decision>/.

Une expression est une instruction booléenne composée de jetons de stratégie compacts utilisant les opérateurs & (and logique) et ! (NOT logique). Le jeton de stratégie compact respecte la casse. (Pour plus d’informations sur les stratégies de confidentialité des préférences de plateforme pour les préférences de confidentialité (P3P) et les jetons de stratégie compacts, consultez la spécification du projet W3C : Platform for Privacy Preferences (P3P). La décision est un caractère minuscule unique qui définit l’action à entreprendre sur le cookie dont la stratégie compacte contient le ou les jetons spécifiés. Le tableau suivant répertorie les caractères de décision valides.

Caractère Définition
a Acceptez le cookie.
p Inviter l’utilisateur à accepter ou refuser le cookie.
r Rejetez le cookie.
l Laissez le cookie (envoyez-le uniquement dans un contexte interne).
d Rétrogradez le cookie, s’il s’agit d’un cookie persistant, en cookie de session.
 

Les règles logiques sont évaluées dans l’ordre dans lequel elles sont répertoriées. La première règle logique à mettre en correspondance, le cas échéant, détermine l’action du cookie.

Une expression vide est également autorisée. Si une expression est vide, le côté gauche prend la valeur true. Cette forme de règle logique peut être utilisée à la fin d’un ensemble de règles pour intercepter toutes les situations qui n’entrent pas dans les autres catégories.

Les exemples suivants montrent des règles logiques valides.

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

Les règles spéciales sont spécifiées à l’aide des symboles nopolicy, session et always. Le symbole nopolicy est utilisé pour spécifier l’action à entreprendre en l’absence de stratégie compacte. Par exemple, nopolicy=d spécifie de passer à une version antérieure de tous les cookies sans stratégie compacte aux cookies de session. Le symbole de session est utilisé pour spécifier l’action à entreprendre sur les cookies de session et ne peut être défini que sur un . Lorsque session=a est spécifié, tous les cookies de session sont acceptés quel que soit le contenu de la stratégie compact. Si cette règle n’est pas spécifiée, les cookies de session sont soumis aux mêmes règles que les cookies persistants. Enfin, le symbole always est utilisé pour spécifier d’effectuer la même action pour tout. Par exemple, always=d spécifie de refuser tous les cookies, quelle que soit l’existence d’une stratégie compacte. Notez que always=d est équivalent à /=d/.

L’exemple suivant montre une chaîne de préférences de confidentialité qui spécifie d’accepter les cookies pour lesquels la stratégie compact contient une paire de jetons FIN/CONi, de rejeter les cookies avec des stratégies compactes contenant des paires de jetons FIN/CON, FIN/CONo, FIN/CONa et GOV/PUB ou un jeton TEL, et d’inviter l’utilisateur quand la stratégie compacte d’un cookie contient le jeton UNR. Il spécifie également de passer à une version antérieure des cookies sans stratégie compacte pour les cookies de session et d’accepter tous les cookies qui ne correspondent pas à l’une des règles spécifiées. Notez que la première règle qui prend la valeur true détermine l’action du cookie.

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

Comme tous les autres aspects de l’API WinINet, cette fonction ne peut pas être appelée en toute sécurité à partir de DllMain ou des constructeurs et destructeurs d’objets globaux.

Note WinINet ne prend pas en charge les implémentations de serveur. En outre, il ne doit pas être utilisé à partir d’un service. Pour les implémentations de serveur ou les services, utilisez Microsoft Windows HTTP Services (WinHTTP).
 

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winineti.h (inclure Wininet.h)
Bibliothèque Wininet.lib
DLL Wininet.dll

Voir aussi

InternetClearAllPerSiteCookieDecisions

InternetEnumPerSiteCookieDecision

InternetGetPerSiteCookieDecision

InternetSetPerSiteCookieDecision

PrivacyGetZonePreferenceW