InternetSetCookieExW

InternetSetCookieEx 関数は、指定された URL に関連付けられた指定の名前のクッキーを作成する。本関数はサードパーティクッキーを作成できる点で InternetSetCookie 関数と異なる。(Unicode)

InternetSetCookieExW lpszUrl, lpszCookieName, lpszCookieData, dwFlags, dwReserved

lpszUrl : [wstr] クッキーを設定する URL を格納した null 終端文字列へのポインタ。本ポインタが NULL の場合、InternetSetCookieEx は ERROR_INVALID_PARAMETER エラーで失敗する。
lpszCookieName : [wstr] 本クッキーに関連付ける名前を格納した null 終端文字列へのポインタ。本ポインタが NULL の場合、クッキーには名前が関連付けられない。
lpszCookieData : [wstr] 新しいクッキーに関連付けるデータを格納した null 終端文字列へのポインタ。本ポインタが NULL の場合、InternetSetCookieEx は ERROR_INVALID_PARAMETER エラーで失敗する。
dwFlags : [int] 関数がクッキーデータを取得する方法を制御するフラグ。
dwReserved : [int] NULL、またはクッキーに関連付ける Platform-for-Privacy-Protection (P3P) ヘッダーへのポインタ。

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

解説

InternetSetCookieEx 関数は、指定された URL
に関連付けられた指定の名前のクッキーを作成する。本関数はサードパーティクッキーを作成できる点で InternetSetCookie
関数と異なる。(Unicode)

[戻り値]
成功した場合は InternetCookieState 列挙のメンバを、失敗した場合は FALSE を返す。失敗時に
GetLastError の呼び出しが ERROR_NOT_ENOUGH_MEMORY
を返した場合、システムメモリが不足していたことを示す。

[備考]
注意: WinINet はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは
Microsoft Windows HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは InternetSetCookieEx
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報