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_COOKIEdwFlags 成员设置了XHR_COOKIE_IS_SESSION标志,则仅为应用的当前会话设置 Cookie。

在 Windows 桌面应用程序中使用时, SetCookie 方法默认设置一个系统范围且由所有 Windows 桌面应用程序共享的持久性 Cookie。 如果XHR_COOKIEdwFlags 成员设置了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