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 |