Fonction InternetSetCookieEx2 (wininet.h)

Article
08/27/2023

Crée un cookie associé à l’URL spécifiée.

Syntaxe

DWORD InternetSetCookieEx2(
  PCWSTR                 pcwszUrl,
  const INTERNET_COOKIE2 *pCookie,
  PCWSTR                 pcwszP3PPolicy,
  DWORD                  dwFlags,
  PDWORD                 pdwCookieState
);

Paramètres

pcwszUrl

URL pour laquelle définir le cookie.

pCookie

Pointeur vers une structure de INTERNET_COOKIE2 contenant les données de cookie.

pcwszP3PPolicy

Chaîne contenant la stratégie P3P (Platform-for-Privacy-Protection) pour le cookie. Peut être NULL.

dwFlags

Indicateurs pour le cookie à définir. Les indicateurs suivants sont disponibles.

Valeur	Signification
INTERNET_COOKIE_THIRD_PARTY	Définissez ce cookie dans un contexte tiers.
INTERNET_COOKIE_PROMPT_REQUIRED	Affichez une invite d’interface utilisateur pour que l’utilisateur accepte ou rejette ce cookie.
INTERNET_COOKIE_EVALUATE_P3P	Évaluez la stratégie P3P fournie pour ce cookie. Cette opération évalue la stratégie par défaut lorsque pcwszP3PPolicy a la valeur NULL.
INTERNET_COOKIE_NON_SCRIPT	Indiquez que ce cookie n’est pas défini via JavaScript, ce qui permet de définir des cookies HTTP uniquement.
INTERNET_COOKIE_APPLY_HOST_ONLY	Appliquez une stratégie d’hôte uniquement à ce cookie. Si l’attribut de domaine n’est pas défini, ce cookie est marqué comme hôte uniquement.

pdwCookieState

Pointeur vers un DWORD qui reçoit le résultat de la définition du cookie. Pour obtenir la liste des valeurs possibles, consultez InternetCookieState.

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite ou un code d’erreur système en cas d’échec.

Remarques

Notes

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 8.1 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 R2 [applications de bureau uniquement]
En-tête	wininet.h
Bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi