InternetSetCookieEx2 函式 (wininet.h)

發行項
03/08/2023

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

語法

DWORD InternetSetCookieEx2(
  PCWSTR                 pcwszUrl,
  const INTERNET_COOKIE2 *pCookie,
  PCWSTR                 pcwszP3PPolicy,
  DWORD                  dwFlags,
  PDWORD                 pdwCookieState
);

參數

pcwszUrl

要設定 Cookie 的 URL。

pCookie

包含 Cookie 資料的 INTERNET_COOKIE2 結構的指標。

pcwszP3PPolicy

字串，其中包含 Cookie 的 Platform-for-Privacy-Protection (P3P) 原則。可能是 NULL。

dwFlags

要設定 Cookie 的旗標。以下是可用的旗標。

值	意義
INTERNET_COOKIE_THIRD_PARTY	在協力廠商內容中設定此 Cookie。
INTERNET_COOKIE_PROMPT_REQUIRED	顯示使用者接受或拒絕此 Cookie 的 UI 提示。
INTERNET_COOKIE_EVALUATE_P3P	評估此 Cookie 所提供的 P3P 原則。當 pcwszP3PPolicy 為 Null 時，這會評估預設原則。
INTERNET_COOKIE_NON_SCRIPT	指出此 Cookie 未透過 JavaScript 設定，允許設定僅限 HTTP 的 Cookie。
INTERNET_COOKIE_APPLY_HOST_ONLY	將僅限主機原則套用至此 Cookie。如果未設定網域屬性，則此 Cookie 會標示為僅限主機。

pdwCookieState

接收設定 Cookie 結果的 DWORD 指標。如需可能值的清單，請參閱 InternetCookieState。

傳回值

如果成功，則傳回ERROR_SUCCESS，或在失敗時傳回系統錯誤碼。

備註

注意

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

規格需求


最低支援的用戶端	Windows 8.1 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 R2 [僅限傳統型應用程式]
標頭	wininet.h
程式庫	Wininet.lib
Dll	Wininet.dll