Partager via

XHR_COOKIE structure (msxml6.h)

  • Article

Définit un cookie que vous pouvez ajouter au fichier jar de cookies HTTP en appelant la méthode SetCookie ou récupérer à partir du fichier jar de cookie HTTP en appelant la méthode GetCookie .

Syntaxe

typedef struct tagXHR_COOKIE {
  WCHAR    *pwszUrl;
  WCHAR    *pwszName;
  WCHAR    *pwszValue;
  WCHAR    *pwszP3PPolicy;
  FILETIME ftExpires;
  DWORD    dwFlags;
} XHR_COOKIE;

Membres

pwszUrl

Chaîne terminée par null qui spécifie l’URL dans le cookie.

pwszName

Chaîne terminée par null qui spécifie le nom dans le cookie.

pwszValue

Chaîne terminée par null qui spécifie la valeur dans le cookie.

pwszP3PPolicy

Chaîne terminée par null qui spécifie la stratégie utilisateur dans le cookie.

ftExpires

Chaîne terminée par null qui spécifie la date et l’heure d’expiration du cookie.

dwFlags

Ensemble d’indicateurs de bits qui spécifie les propriétés du cookie.

Ce membre peut être l’une des valeurs du type d’énumération XHR_COOKIE_FLAG défini dans le fichier d’en-tête Msxml6.h .

Valeur Signification
XHR_COOKIE_IS_SECURE
0x1
XHR_COOKIE_IS_SESSION
0x2
 Le cookie est un cookie de session et non un cookie persistant.
XHR_COOKIE_THIRD_PARTY
0x10
 Indique que le cookie en cours de définition est un cookie tiers.
XHR_COOKIE_PROMPT_REQUIRED
0x20
XHR_COOKIE_EVALUATE_P3P
0x40
 Si cet indicateur est défini, le membre pwszP3PPolicy pointe vers un en-tête Platform-for-Privacy-Protection (P3P) pour le cookie en question.
XHR_COOKIE_APPLY_P3P
0x80
XHR_COOKIE_APPLY_P3P
0x100
XHR_COOKIE_IS_RESTRICTED
0x200
 Indique que le cookie défini est associé à un site non approuvé.
XHR_COOKIE_IE6
0x400
XHR_COOKIE_IS_LEGACY
0x800
XHR_COOKIE_NON_SCRIPT
0x1000
XHR_COOKIE_HTTPONLY
0x2000
 Active la récupération des cookies marqués comme « HTTPOnly ».

N’utilisez pas cet indicateur si vous exposez une interface pouvant faire l’objet d’un script, car cela a des implications en matière de sécurité. Si vous exposez une interface pouvant faire l’objet d’un script, vous pouvez devenir un vecteur d’attaque pour les attaques par script intersites. Il est impératif que vous utilisiez cet indicateur uniquement s’ils peuvent garantir que vous n’autoriserez jamais le code tiers à définir un cookie à l’aide de cet indicateur au moyen d’un mécanisme d’extensibilité que vous fournissez.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau | Applications UWP],MSXML 6.0 et versions ultérieures
Serveur minimal pris en charge Windows Server 2012 [applications de bureau | Applications UWP]
En-tête msxml6.h

Voir aussi

IXMLHTTPRequest2, interface

SetCookie, méthode

SetProperty, méthode