InternetGetCookieEx2 函数 (wininet.h)

检索与指定 URL 关联的一个或多个 Cookie。

语法

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

参数

pcwszUrl

要检索其 Cookie 的 URL。

pcwszCookieName

要检索的 Cookie 的名称。 可以为 NULL。

dwFlags

要检索的 Cookie 的标志。 以下标志可用。

含义
INTERNET_COOKIE_THIRD_PARTY 以第三方身份检索 Cookie,导致排除仅第一方 Cookie。
INTERNET_COOKIE_NON_SCRIPT 指示此查询不是通过 JavaScript 触发的,允许检索仅限 HTTP 的 Cookie。
INTERNET_COOKIE_SAME_SITE_LEVEL_CROSS_SITE 像在跨站点上下文中一样检索 Cookie,不包括设置了 SameSite 属性的 Cookie。
INTERNET_FLAG_RESTRICTED_ZONE 仅检索指定 URL 不受信任时允许的 Cookie;也就是说,如果属于URLZONE_UNTRUSTED区域,则为 。

ppCookies

接收INTERNET_COOKIE2结构的数组 指针。 返回的数组必须由 InternetFreeCookies 释放。

pdwCookieCount

指向接收数组中结构数的 DWORD 的指针。

返回值

如果成功,则返回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

InternetSetCookieEx2

InternetFreeCookies

WinINet 函数