InternetSetCookieExA 函式（wininet.h）

發行項
11/20/2024

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

語法

DWORD InternetSetCookieExA(
  [in] LPCSTR    lpszUrl,
  [in] LPCSTR    lpszCookieName,
  [in] LPCSTR    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 參數轉換成指向有問題的 Cookie 平臺Privacy-Protection LPCTSTR。
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 相關聯的平臺 for-for-Privacy-Protection （P3P）標頭指標。

傳回值

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

言論

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

注意

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

要求

要求	價值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
支援的最低伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平臺	窗戶
標頭	wininet.h
連結庫	Wininet.lib
DLL	Wininet.dll