Fonction InternetSetCookieEx2 (wininet.h)
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 |