InternetSetCookieEx2 関数 (wininet.h)
指定した 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 にホスト専用ポリシーを適用します。 domain 属性が設定されていない場合、この Cookie はホスト専用としてマークされます。 |
pdwCookieState
Cookie を設定した結果を受け取る DWORD へのポインター。 使用可能な値の一覧については、「 InternetCookieState」を参照してください。
戻り値
成功した場合はERROR_SUCCESS、失敗した場合は システム エラー コード を返します。
解説
注意
WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。
要件
| サポートされている最小のクライアント | Windows 8.1 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 R2 [デスクトップ アプリのみ] |
| Header | wininet.h |
| Library | Wininet.lib |
| [DLL] | Wininet.dll |