InternetSetCookieW

指定した URL に関連付けられたクッキーを作成する。(InternetSetCookieW)

InternetSetCookieW lpszUrl, lpszCookieName, lpszCookieData

lpszUrl : [wstr] クッキーを設定する URL を指定する null 終端文字列へのポインタ。
lpszCookieName : [wstr] クッキーデータに関連付ける名前を指定する null 終端文字列へのポインタ。本パラメータが NULL の場合、クッキーには名前が関連付けられない。
lpszCookieData : [wstr] URL に関連付ける実際のデータへのポインタ。

(プラグイン / モジュール : wininet.dll)

解説

指定した URL に関連付けられたクッキーを作成する。(InternetSetCookieW)

[戻り値]
成功した場合は TRUE を、失敗した場合は FALSE を返す。具体的なエラーメッセージを取得するには GetLastError
を呼び出す。

[備考]
InternetSetCookie
で有効期限なしに作成されたクッキーはメモリに格納され、それらを作成した同一プロセス内でのみ利用可能である。有効期限を含むクッキーは
windows\cookies
ディレクトリに格納される。新しいクッキーの作成は、ユーザーのプライバシー設定に基づいて、本サイトからのクッキーを許可するか拒否するかをユーザーに尋ねるダイアログボックスを画面に表示することがある。
注意: InternetSetCookie は、Internet Explorer
で「すべてのクッキーをブロック」が設定されている場合でも、無条件にクッキーを作成する。「すべてのクッキーをブロック」設定が有効な間、そのようなクッキーがその後サーバーに送り返されることはないが、この動作はプライバシーの侵害と見なされる可能性がある。アプリケーションはユーザーのプライバシー設定を正しく尊重するために
InternetSetCookieEx を使用すべきである。クッキーの内部仕様の詳細については
http://blogs.msdn.com/ieinternals/archive/2009/08/20/WinINET-IE-Cookie-Internals-FAQ.aspx
を参照のこと。
WinINet API の他のすべての側面と同様に、本関数は DllMain
やグローバルオブジェクトのコンストラクタ・デストラクタの中から安全に呼び出すことはできない。注意: WinINet
はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは Microsoft Windows
HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは InternetSetCookie をエイリアスとして定義しており、UNICODE
プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報