InternetSetCookieExA 函式 (wininet.h)

發行項
08/27/2023

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 參數會轉換成 LPCTSTR ，指向有問題的 Cookie 的 Platform-for-Privacy-Protection (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 Services (WinHTTP) 。

注意

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

規格需求


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