InternetSetCookieExA, fonction (wininet.h)

Article
11/20/2024

La fonction InternetSetCookieEx crée un cookie portant un nom spécifié associé à une URL spécifiée. Cette fonction diffère de la fonction InternetSetCookie en étant en mesure de créer des cookies tiers.

Syntaxe

DWORD InternetSetCookieExA(
  [in] LPCSTR    lpszUrl,
  [in] LPCSTR    lpszCookieName,
  [in] LPCSTR    lpszCookieData,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwReserved
);

Paramètres

[in] lpszUrl

Pointeur vers une chaîne null-terminated qui contient l’URL pour laquelle le cookie doit être défini.

Si ce pointeur est NULL, InternetSetCookieEx échoue avec une erreur de ERROR_INVALID_PARAMETER.

[in] lpszCookieName

Pointeur vers une chaîne null-terminated qui contient le nom à associer à ce cookie. Si ce pointeur est NULL, aucun nom n’est associé au cookie.

[in] lpszCookieData

Pointeur vers une chaîne null-terminated qui contient les données à associer au nouveau cookie.

Si ce pointeur est NULL, InternetSetCookieEx échoue avec une erreur de ERROR_INVALID_PARAMETER.

[in] dwFlags

Indicateurs qui contrôlent la façon dont la fonction récupère les données de cookie :

Valeur	Signification
INTERNET_COOKIE_EVALUATE_P3P	Si cet indicateur est défini et que le paramètre dwReserved n’est pas NULL, le paramètre dwReserved est converti en LPCTSTR qui pointe vers un en-tête Platform-for-Privacy-Protection (P3P) pour le cookie en question.
INTERNET_COOKIE_HTTPONLY	Active la récupération des cookies marqués comme « HTTPOnly ». N’utilisez pas cet indicateur si vous exposez une interface scriptable, car cela a des implications en matière de sécurité. Si vous exposez une interface scriptable, vous pouvez devenir un vecteur d’attaque pour les attaques de script intersites. Il est absolument 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 par le biais d’un mécanisme d’extensibilité que vous fournissez. version : nécessite Internet Explorer 8.0 ou version ultérieure.
INTERNET_COOKIE_THIRD_PARTY	Indique que le cookie en cours de définition est un cookie tiers.
INTERNET_FLAG_RESTRICTED_ZONE	Indique que le cookie en cours de définition est associé à un site non approuvé.

[in] dwReserved

NULL ou contient un pointeur vers un en-tête Platform-for-Privacy-Protection (P3P) à associer au cookie.

Valeur de retour

Retourne un membre de l’énumération InternetCookieState en cas de réussite, ou FALSE si la fonction échoue. En cas d’échec, si un appel à GetLastError retourne ERROR_NOT_ENOUGH_MEMORY, la mémoire système insuffisante était disponible.

Remarques

Remarque 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).

Note

L’en-tête wininet.h définit InternetSetCookieEx comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wininet.h
bibliothèque	Wininet.lib
DLL	Wininet.dll