InternetSetCookieEx2 function (wininet.h)

Article
02/22/2024

Creates a cookie associated with the specified URL.

Syntax

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

Parameters

pcwszUrl

The URL for which to set the cookie.

pCookie

Pointer to an INTERNET_COOKIE2 structure containing the cookie data.

pcwszP3PPolicy

String containing the Platform-for-Privacy-Protection (P3P) policy for the cookie. May be NULL.

dwFlags

Flags for the cookie to be set. The following flags are available.

Value	Meaning
INTERNET_COOKIE_THIRD_PARTY	Set this cookie in a third-party context.
INTERNET_COOKIE_PROMPT_REQUIRED	Show a UI prompt for the user to accept or reject this cookie.
INTERNET_COOKIE_EVALUATE_P3P	Evaluate the provided P3P policy for this cookie. This will evaluate default policy when pcwszP3PPolicy is NULL.
INTERNET_COOKIE_NON_SCRIPT	Indicate that this cookie is not being set via JavaScript, allowing HTTP-only cookies to be set.
INTERNET_COOKIE_APPLY_HOST_ONLY	Apply host-only policy to this cookie. If the domain attribute is not set, then this cookie will be marked host-only.

pdwCookieState

Pointer to a DWORD that receives the result of setting the cookie. For a list of possible values, see InternetCookieState.

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