IXMLHTTPRequest2：：SetCookie 方法 (msxml6.h)

在 HTTP Cookie jar 中設定與指定 URL 相關聯的 Cookie。

語法

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

參數

pCookie

XHR_COOKIE 結構的指標，指定要與指定 URL 相關聯的 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旗標時，Cookie 只會針對 Windows 傳統型應用程式的目前會話進行設定。

規格需求

需求	值
最低支援的用戶端	Windows 8 [傳統型應用程式 |UWP 應用程式]，MSXML 6.0 和更新版本
最低支援的伺服器	Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	msxml6.h

另請參閱

GetCookie 方法

IXMLHTTPRequest2

XHR_COOKIE 結構

XHR_COOKIE_STATE