InternetGetCookieEx2 函式 (wininet.h)

發行項
03/04/2024

擷取一或多個與指定 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