InternetSetCookieEx2 函式 (wininet.h)
建立與指定 URL 相關聯的 Cookie。
語法
DWORD InternetSetCookieEx2(
PCWSTR pcwszUrl,
const INTERNET_COOKIE2 *pCookie,
PCWSTR pcwszP3PPolicy,
DWORD dwFlags,
PDWORD pdwCookieState
);
參數
pcwszUrl
要設定 Cookie 的 URL。
pCookie
包含 Cookie 資料的 INTERNET_COOKIE2 結構的指標。
pcwszP3PPolicy
字串，其中包含 Cookie 的 Platform-for-Privacy-Protection (P3P) 原則。 可能是 NULL。
dwFlags
要設定 Cookie 的旗標。 以下是可用的旗標。
| 值 | 意義 |
|---|---|
| INTERNET_COOKIE_THIRD_PARTY | 在協力廠商內容中設定此 Cookie。 |
| INTERNET_COOKIE_PROMPT_REQUIRED | 顯示使用者接受或拒絕此 Cookie 的 UI 提示。 |
| INTERNET_COOKIE_EVALUATE_P3P | 評估此 Cookie 所提供的 P3P 原則。 當 pcwszP3PPolicy 為 Null 時，這會評估預設原則。 |
| INTERNET_COOKIE_NON_SCRIPT | 指出此 Cookie 未透過 JavaScript 設定，允許設定僅限 HTTP 的 Cookie。 |
| INTERNET_COOKIE_APPLY_HOST_ONLY | 將僅限主機原則套用至此 Cookie。 如果未設定網域屬性，則此 Cookie 會標示為僅限主機。 |
pdwCookieState
接收設定 Cookie 結果的 DWORD 指標。 如需可能值的清單，請參閱 InternetCookieState。
傳回值
如果成功，則傳回ERROR_SUCCESS，或在失敗時 傳回系統錯誤碼 。
備註
注意
WinINet 不支援伺服器實作。 此外，不應該從服務使用它。 對於伺服器實作或服務，請使用 Microsoft Windows HTTP Services (WinHTTP) 。
規格需求
| 最低支援的用戶端 | Windows 8.1 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 R2 [僅限傳統型應用程式] |
| 標頭 | wininet.h |
| 程式庫 | Wininet.lib |
| Dll | Wininet.dll |