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枚举类型的值之一。
返回值
如果成功,则返回 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 |