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

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 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

Voir aussi

GetCookie, méthode

IXMLHTTPRequest2

XHR_COOKIE Structure

XHR_COOKIE_STATE