次の方法で共有


InternetSetCookieExA 関数 (wininet.h)

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

構文

DWORD InternetSetCookieExA(
  [in] LPCSTR    lpszUrl,
  [in] LPCSTR    lpszCookieName,
  [in] LPCSTR    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 を設定することを決して許可しない場合にのみ使用することが完全に不可欠です。

バージョン: 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 ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetSetCookieEx を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー wininet.h
ライブラリ Wininet.lib
DLL Wininet.dll

関連項目

HTTP Cookie を する

InternetGetCookie

InternetGetCookieEx

InternetSetCookie

Cookie の管理の

WinINet Functions の