XHR_COOKIE结构 (msxml6.h)

定义一个 Cookie,可以通过调用 SetCookie 方法添加到 HTTP Cookie jar,或通过调用 GetCookie 方法从 HTTP Cookie jar 进行检索。

语法

typedef struct tagXHR_COOKIE {
  WCHAR    *pwszUrl;
  WCHAR    *pwszName;
  WCHAR    *pwszValue;
  WCHAR    *pwszP3PPolicy;
  FILETIME ftExpires;
  DWORD    dwFlags;
} XHR_COOKIE;

成员

pwszUrl

一个以 null 结尾的字符串,指定 Cookie 中的 URL。

pwszName

一个以 null 结尾的字符串,指定 Cookie 中的名称。

pwszValue

一个以 null 结尾的字符串,指定 Cookie 中的值。

pwszP3PPolicy

一个以 null 结尾的字符串,用于指定 Cookie 中的用户策略。

ftExpires

一个以 null 结尾的字符串,指定 Cookie 过期的日期和时间。

dwFlags

一组指定 Cookie 属性的位标志。

此成员可以是 msxml6.h 头文件中定义的 XHR_COOKIE_FLAG 枚举类型的值之一。

含义
XHR_COOKIE_IS_SECURE
0x1
XHR_COOKIE_IS_SESSION
0x2
Cookie 是会话 Cookie,而不是永久性 Cookie。
XHR_COOKIE_THIRD_PARTY
0x10
指示正在设置的 Cookie 是第三方 Cookie。
XHR_COOKIE_PROMPT_REQUIRED
0x20
XHR_COOKIE_EVALUATE_P3P
0x40
如果设置了此标志, 则 pwszP3PPolicy 成员指向有关 Cookie 的平台 for-Privacy-Protection (P3P) 标头。
XHR_COOKIE_APPLY_P3P
0x80
XHR_COOKIE_APPLY_P3P
0x100
XHR_COOKIE_IS_RESTRICTED
0x200
指示所设置的 Cookie 与不受信任的站点相关联。
XHR_COOKIE_IE6
0x400
XHR_COOKIE_IS_LEGACY
0x800
XHR_COOKIE_NON_SCRIPT
0x1000
XHR_COOKIE_HTTPONLY
0x2000
启用对标记为“HTTPOnly”的 Cookie 的检索。

如果公开可编写脚本的接口,请不要使用此标志,因为这具有安全隐患。 如果公开可编写脚本的接口,则可以成为跨站点脚本攻击的攻击途径。 仅当第三方代码可以保证你永远不会允许第三方代码通过你提供的扩展性机制来设置使用此标志的 Cookie 时,才必须使用此标志。

要求

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

另请参阅

IXMLHTTPRequest2 接口

SetCookie 方法

SetProperty 方法