InternetGetCookieEx2 function (wininet.h)

Article
07/23/2021

Retrieves one or more cookies associated with the specified URL.

Syntax

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

Parameters

pcwszUrl

The URL for which to retrieve cookies.

pcwszCookieName

The name of the cookie to retrieve. May be NULL.

dwFlags

Flags of the cookie to retrieve. The following flags are available.

Value	Meaning
INTERNET_COOKIE_THIRD_PARTY	Retrieve cookies as a third party, causing first-party-only cookies to be excluded.
INTERNET_COOKIE_NON_SCRIPT	Indicate that this query was not triggered via JavaScript, allowing retrieval of HTTP-only cookies.
INTERNET_COOKIE_SAME_SITE_LEVEL_CROSS_SITE	Retrieve cookies as if in a cross site context, excluding cookies with the SameSite property set.
INTERNET_FLAG_RESTRICTED_ZONE	Retrieve only cookies that would be allowed if the specified URL were untrusted; that is, if it belonged to the URLZONE_UNTRUSTED zone.

ppCookies

Pointer that receives an array of INTERNET_COOKIE2 structures. The returned array must be freed by InternetFreeCookies.

pdwCookieCount

Pointer to a DWORD that receives the number of structures in the array.

Return value

Returns ERROR_SUCCESS if successful, or a system error code on failure.

Remarks

Note

WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).

Requirements

Requirement	Value
Minimum supported client	Windows 8.1 [desktop apps only]
Minimum supported server	Windows Server 2012 R2 [desktop apps only]
Header	wininet.h
Library	Wininet.lib
DLL	Wininet.dll