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 |