IXMLHTTPRequest2 ::SetCookie, méthode (msxml6.h)

Article
02/29/2024

Définit un cookie associé à l’URL spécifiée dans le fichier jar de cookie HTTP.

Syntaxe

HRESULT SetCookie(
  const XHR_COOKIE *pCookie,
  DWORD            *pdwCookieState
);

Paramètres

pCookie

Pointeur vers une structure de XHR_COOKIE qui spécifie le cookie et les propriétés du cookie à associer à l’URL spécifiée.

pdwCookieState

Pointeur vers une valeur qui indique l’état du cookie si l’appel se termine correctement.

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

Valeur	Signification
XHR_COOKIE_STATE_UNKNOWN 0	Réservé.
XHR_COOKIE_STATE_ACCEPT 1	Le cookie a été accepté.
XHR_COOKIE_STATE_PROMPT 2	L’utilisateur est invité à accepter ou refuser le cookie.
XHR_COOKIE_STATE_LEASH 3	Le cookie est accepté uniquement dans le contexte interne.
XHR_COOKIE_STATE_DOWNGRADE 4	Le cookie a été accepté et est devenu cookie de session.
XHR_COOKIE_STATE_REJECT 5	Le cookie a été rejeté.

Valeur retournée

Renvoie S_OK en cas de réussite.

Remarques

La méthode SetCookie a un comportement différent pour les applications du Windows Store et les applications de bureau Windows.

Lorsqu’elle est utilisée dans une application du Windows Store, la méthode SetCookie définit par défaut le cookie en tant que cookie persistant dans l’application du Windows Store. Lorsque le membre dwFlags du XHR_COOKIE a l’indicateur XHR_COOKIE_IS_SESSION défini, le cookie est défini uniquement pour la session active de l’application.

Lorsqu’elle est utilisée dans une application de bureau Windows, la méthode SetCookie définit par défaut un cookie persistant à l’échelle du système et partagé par toutes les applications de bureau Windows. Lorsque le membre dwFlags du XHR_COOKIE a l’indicateur XHR_COOKIE_IS_SESSION défini, le cookie est défini uniquement pour la session actuelle de l’application de bureau Windows.

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]
Plateforme cible	Windows
En-tête	msxml6.h

Voir aussi

Partager via