iXMLHTTPRequest2：：SetCookie 方法 (msxml6.h)

设置与 HTTP Cookie jar 中的指定 URL 关联的 Cookie。

语法

HRESULT SetCookie(
  const XHR_COOKIE *pCookie,
  DWORD            *pdwCookieState
);

参数

pCookie

指向 XHR_COOKIE 结构的指针，该结构指定要与指定 URL 关联的 Cookie 和 Cookie 的属性。

pdwCookieState

指向一个值的指针，该值指示调用成功完成时 Cookie 状态。

此参数可以是 msxml6.h 头文件中定义的XHR_COOKIE_STATE枚举类型的值之一。

值	含义
XHR_COOKIE_STATE_UNKNOWN 0	保留。
XHR_COOKIE_STATE_ACCEPT 1	Cookie 已被接受。
XHR_COOKIE_STATE_PROMPT 2	系统会提示用户接受或拒绝 Cookie。
XHR_COOKIE_STATE_LEASH 3	仅在第一方上下文中接受 Cookie。
XHR_COOKIE_STATE_DOWNGRADE 4	Cookie 已被接受并成为会话 Cookie。
XHR_COOKIE_STATE_REJECT 5	Cookie 被拒绝。

返回值

如果成功，则返回 S_OK。

注解

SetCookie 方法对 Windows 应用商店应用和 Windows 桌面应用程序具有不同的行为。

在 Windows 应用商店应用中使用时， SetCookie 方法默认将 Cookie 设置为 Windows 应用商店应用中的持久性 Cookie。 如果XHR_COOKIE的 dwFlags 成员设置了XHR_COOKIE_IS_SESSION标志，则仅为应用的当前会话设置 Cookie。

在 Windows 桌面应用程序中使用时， SetCookie 方法默认设置一个系统范围且由所有 Windows 桌面应用程序共享的持久性 Cookie。 如果XHR_COOKIE的 dwFlags 成员设置了XHR_COOKIE_IS_SESSION标志，则仅为 Windows 桌面应用程序的当前会话设置 Cookie。

要求

要求	值
最低受支持的客户端	Windows 8 [桌面应用 |UWP 应用]，MSXML 6.0 及更高版本
最低受支持的服务器	Windows Server 2012 [桌面应用 |UWP 应用]
目标平台	Windows
标头	msxml6.h

另请参阅

GetCookie 方法

IXMLHTTPRequest2

XHR_COOKIE 结构

XHR_COOKIE_STATE