InternetSetCookieExW 函式 (wininet.h)

發行項
03/13/2024

InternetSetCookieEx 函式會建立具有指定名稱的 Cookie，該名稱與指定的 URL 相關聯。此函式與 InternetSetCookie 函式不同，方法是能夠建立第三方 Cookie。

語法

DWORD InternetSetCookieExW(
  [in] LPCWSTR   lpszUrl,
  [in] LPCWSTR   lpszCookieName,
  [in] LPCWSTR   lpszCookieData,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwReserved
);

參數

[in] lpszUrl

Null 終止字串的指標，其中包含應該設定 Cookie 的 URL。

如果此指標為 NULL，InternetSetCookieEx 會失敗，併發生ERROR_INVALID_PARAMETER錯誤。

[in] lpszCookieName

Null 終止字串的指標，其中包含要與此 Cookie 建立關聯的名稱。如果此指標為 NULL，則沒有與 Cookie 相關聯的名稱。

[in] lpszCookieData

Null 終止字串的指標，其中包含要與新 Cookie 相關聯的數據。

如果此指標為 NULL，InternetSetCookieEx 會失敗，併發生ERROR_INVALID_PARAMETER錯誤。

[in] dwFlags

控制函式如何擷取 Cookie 數據的旗標：

值	意義
INTERNET_COOKIE_EVALUATE_P3P	如果設定此旗標且 dwReserved 參數不是 NULL，則 dwReserved 參數會轉換成 LPCTSTR，指向有問題的 Cookie (P3P (P3P) 標頭。
INTERNET_COOKIE_HTTPONLY	啟用擷取標示為「HTTPOnly」的 Cookie。如果您公開可編寫腳本的介面，請勿使用此旗標，因為這具有安全性影響。如果您公開可編寫腳本的介面，您可以成為跨網站腳本攻擊的攻擊媒介。只有當旗標可以保證您永遠不會允許第三方程式代碼透過您提供的擴充性機制來設定 Cookie 時，才使用這個旗標絕對命令式。版本：需要 Internet Explorer 8.0 或更新版本。
INTERNET_COOKIE_THIRD_PARTY	指出所設定的 Cookie 是第三方 Cookie。
INTERNET_FLAG_RESTRICTED_ZONE	指出所設定的 Cookie 與不受信任的網站相關聯。

[in] dwReserved

NULL，或包含與 Cookie 相關聯之 Platform-for-Privacy-Protection (P3P) 標頭的指標。

傳回值

如果成功，則會傳回 InternetCookieState 列舉的成員，如果函式失敗，則傳回 FALSE 。失敗時，如果對 GetLastError 的呼叫傳回ERROR_NOT_ENOUGH_MEMORY，系統記憶體不足。

備註

注意 WinINet 不支援伺服器實作。此外，它不應該從服務使用。對於伺服器實作或服務，請使用 Microsoft Windows HTTP 服務 (WinHTTP) 。

注意

wininet.h 標頭會將 InternetSetCookieEx 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	wininet.h
程式庫	Wininet.lib
Dll	Wininet.dll