InternetSetCookieA 函式（wininet.h）

發行項
11/20/2024

建立與指定 URL 相關聯的 Cookie。

語法

BOOL InternetSetCookieA(
  [in] LPCSTR lpszUrl,
  [in] LPCSTR lpszCookieName,
  [in] LPCSTR lpszCookieData
);

參數

[in] lpszUrl

null終止字串的指標，指定應該設定 Cookie 的 URL。

[in] lpszCookieName

null 的指標終止字串，指定要與 Cookie 數據相關聯的名稱。如果此參數 NULL，則沒有任何名稱與 Cookie 相關聯。

[in] lpszCookieData

與 URL 相關聯之實際數據的指標。

傳回值

如果成功，則傳回 true true，否則會 傳回 false。若要取得特定錯誤訊息，請呼叫 GetLastError。

言論

InternetSetCookie 所建立的 Cookie 會儲存在記憶體中，而且只能在建立 Cookie 的相同進程中使用。包含到期日的 Cookie 會儲存在 windows\cookies 目錄中。

建立新的 Cookie 可能會導致對話框出現在畫面上，詢問使用者是否要根據使用者的隱私權設定來允許或不允許來自此網站的 Cookie。

注意InternetSetCookie 即使 Internet Explorer 中設定了「封鎖所有 Cookie」，仍會無條件建立 Cookie。即使這類 Cookie 在「封鎖所有 Cookie」設定為作用中時，不會傳送回伺服器，但此行為仍可視為隱私權缺口。應用程式應該使用 InternetSetCookieEx，正確地接受使用者的隱私權設定。

如需更多 Cookie 內部，請參閱 http://blogs.msdn.com/ieinternals/archive/2009/08/20/WinINET-IE-Cookie-Internals-FAQ.aspx。

如同 WinINet API 的其他所有層面，無法從 DllMain 或全域物件的建構函式和解構函式安全地呼叫此函式。

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

注意

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

要求

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