InternetSetCookieEx2 函数 (wininet.h)

创建与指定 URL 关联的 Cookie。

语法

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

参数

pcwszUrl

要为其设置 Cookie 的 URL。

pCookie

指向包含 cookie 数据的 INTERNET_COOKIE2 结构的指针。

pcwszP3PPolicy

包含适用于 Cookie 的平台隐私保护 (P3P) 策略的字符串。 可以为 NULL。

dwFlags

要设置的 Cookie 的标志。 以下标志可用。

值	含义
INTERNET_COOKIE_THIRD_PARTY	在第三方上下文中设置此 Cookie。
INTERNET_COOKIE_PROMPT_REQUIRED	显示 UI 提示，让用户接受或拒绝此 Cookie。
INTERNET_COOKIE_EVALUATE_P3P	评估为此 Cookie 提供的 P3P 策略。 当 pcwszP3PPolicy 为 NULL 时，这将评估默认策略。
INTERNET_COOKIE_NON_SCRIPT	指示未通过 JavaScript 设置此 Cookie，从而允许设置仅限 HTTP 的 Cookie。
INTERNET_COOKIE_APPLY_HOST_ONLY	将仅主机策略应用于此 Cookie。 如果未设置域属性，则此 Cookie 将标记为仅主机。

pdwCookieState

指向接收设置 Cookie 的结果的 DWORD 的指针。 有关可能值的列表，请参阅 InternetCookieState。

返回值

如果成功，则返回ERROR_SUCCESS;如果失败，则返回 系统错误代码 。

注解

注意

WinINet 不支持服务器实现。 此外，不应从服务使用它。 对于服务器实现或服务，请使用 Microsoft Windows HTTP Services (WinHTTP) 。

要求

最低受支持的客户端	Windows 8.1 [仅限桌面应用]
最低受支持的服务器	Windows Server 2012 R2 [仅限桌面应用]
标头	wininet.h
Library	Wininet.lib
DLL	Wininet.dll

另请参阅

HTTP Cookie

管理 Cookie

InternetGetCookieEx2

InternetFreeCookies

WinINet 函数