InternetGetCookieEx2 函式 (wininet.h)
擷取一或多個與指定 URL 相關聯的 Cookie。
語法
DWORD InternetGetCookieEx2(
PCWSTR pcwszUrl,
PCWSTR pcwszCookieName,
DWORD dwFlags,
INTERNET_COOKIE2 **ppCookies,
PDWORD pdwCookieCount
);
參數
pcwszUrl
要擷取 Cookie 的 URL。
pcwszCookieName
要擷取的Cookie名稱。 可能是 NULL。
dwFlags
要擷取之Cookie的旗標。 下列旗標可供使用。
| 值 | 意義 |
|---|---|
| INTERNET_COOKIE_THIRD_PARTY | 將 Cookie 擷取為第三方，導致排除第一方 Cookie。 |
| INTERNET_COOKIE_NON_SCRIPT | 表示此查詢未透過 JavaScript 觸發，允許擷取僅限 HTTP 的 Cookie。 |
| INTERNET_COOKIE_SAME_SITE_LEVEL_CROSS_SITE | 擷取 Cookie 就像在跨網站內容中，排除已設定 SameSite 屬性的 Cookie。 |
| INTERNET_FLAG_RESTRICTED_ZONE | 只擷取指定 URL 不受信任時允許的 Cookie;也就是說，如果屬於URLZONE_UNTRUSTED區域， |
ppCookies
接收 INTERNET_COOKIE2 結構的陣列指標。 傳回的陣列必須由 InternetFreeCookies 釋放。
pdwCookieCount
接收陣列中結構數目的 DWORD 指標。
傳回值
如果成功，則傳回ERROR_SUCCESS，或在失敗時 傳回系統錯誤碼 。
備註
注意
WinINet 不支援伺服器實作。 此外，它不應該從服務使用。 對於伺服器實作或服務，請使用 Microsoft Windows HTTP 服務 (WinHTTP) 。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8.1 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 R2 [僅限傳統型應用程式] |
| 標頭 | wininet.h |
| 程式庫 | Wininet.lib |
| Dll | Wininet.dll |