Fonction InternetGetCookieEx2 (wininet.h)

Récupère un ou plusieurs cookies associés à l’URL spécifiée.

Syntaxe

DWORD InternetGetCookieEx2(
  PCWSTR           pcwszUrl,
  PCWSTR           pcwszCookieName,
  DWORD            dwFlags,
  INTERNET_COOKIE2 **ppCookies,
  PDWORD           pdwCookieCount
);

Paramètres

pcwszUrl

URL pour laquelle récupérer les cookies.

pcwszCookieName

Nom du cookie à récupérer. Peut être NULL.

dwFlags

Indicateurs du cookie à récupérer. Les indicateurs suivants sont disponibles.

Valeur Signification
INTERNET_COOKIE_THIRD_PARTY Récupérez les cookies en tant que tiers, ce qui entraîne l’exclusion des cookies internes uniquement.
INTERNET_COOKIE_NON_SCRIPT Indiquez que cette requête n’a pas été déclenchée via JavaScript, ce qui permet la récupération des cookies HTTP uniquement.
INTERNET_COOKIE_SAME_SITE_LEVEL_CROSS_SITE Récupérez les cookies comme dans un contexte intersites, à l’exclusion des cookies avec la propriété SameSite définie.
INTERNET_FLAG_RESTRICTED_ZONE Récupérer uniquement les cookies qui seraient autorisés si l’URL spécifiée n’était pas approuvée ; autrement dit, s’il appartenait à la zone URLZONE_UNTRUSTED.

ppCookies

Pointeur qui reçoit un tableau de structures INTERNET_COOKIE2 . Le tableau retourné doit être libéré par InternetFreeCookies.

pdwCookieCount

Pointeur vers un DWORD qui reçoit le nombre de structures dans le tableau.

Valeur retournée

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

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

Condition requise Valeur
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

HTTP Cookies

Gestion des cookies

InternetSetCookieEx2

InternetFreeCookies

Fonctions WinINet