InternetSetCookieExW 関数 (wininet.h)

[アーティクル]
03/09/2024

InternetSetCookieEx 関数は、指定した URL に関連付けられている指定した名前の Cookie を作成します。この関数は、サードパーティの Cookie を作成できることで InternetSetCookie 関数とは異なります。

構文

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

パラメーター

[in] lpszUrl

Cookie を設定する必要がある URL を含む null で終わる文字列へのポインター。

このポインターが NULL の場合、InternetSetCookieEx はERROR_INVALID_PARAMETER エラーで失敗します。

[in] lpszCookieName

この Cookie に関連付ける名前を含む null で終わる文字列へのポインター。このポインターが NULL の場合、名前は Cookie に関連付けされません。

[in] lpszCookieData

新しい Cookie に関連付けるデータを含む null で終わる文字列へのポインター。

このポインターが NULL の場合、InternetSetCookieEx はERROR_INVALID_PARAMETER エラーで失敗します。

[in] dwFlags

関数が Cookie データを取得する方法を制御するフラグ:

値	意味
INTERNET_COOKIE_EVALUATE_P3P	このフラグが設定され、 dwReserved パラメーターが NULL でない場合、 dwReserved パラメーターは、対象の Cookie の Platform-for-Privacy-Protection (P3P) ヘッダーを指す LPCTSTR にキャストされます。
INTERNET_COOKIE_HTTPONLY	"HTTPOnly" としてマークされている Cookie の取得を有効にします。スクリプト可能なインターフェイスを公開する場合は、セキュリティ上の影響があるため、このフラグを使用しないでください。スクリプト可能なインターフェイスを公開すると、クロスサイトスクリプティング攻撃の攻撃ベクトルになる可能性があります。このフラグを使用することは、サードパーティのコードが提供する機能拡張メカニズムを使用してこのフラグを使用して Cookie を設定することを決して許可しない場合にのみ、このフラグを使用することが完全に不可欠です。バージョン：インターネットエクスプローラー 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 ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetSetCookieEx を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	wininet.h
Library	Wininet.lib
[DLL]	Wininet.dll