InternetSetCookieW 関数 (wininet.h)
指定した URL に関連付けられた Cookie を作成します。
構文
BOOL InternetSetCookieW(
[in] LPCWSTR lpszUrl,
[in] LPCWSTR lpszCookieName,
[in] LPCWSTR lpszCookieData
);
パラメーター
[in] lpszUrl
Cookie を設定する URL を指定する null で終わる文字列へのポインター。
[in] lpszCookieName
Cookie データに関連付ける名前を指定する null で終わる文字列へのポインター。 このパラメーターが NULL の場合、名前は Cookie に関連付けされません。
[in] lpszCookieData
URL に関連付ける実際のデータへのポインター。
戻り値
成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。 特定のエラー メッセージを取得するには、 GetLastError を呼び出します。
解説
有効期限のない InternetSetCookie によって作成された Cookie はメモリに格納され、Cookie を作成したのと同じプロセスでのみ使用できます。 有効期限を含む Cookie は、windows\cookies ディレクトリに格納されます。
新しい Cookie を作成すると、ユーザーのプライバシー設定に基づいて、このサイトの Cookie を許可または禁止するかどうかをユーザーに確認するダイアログ ボックスが画面に表示されることがあります。
Cookie 内部の詳細については、「」を参照してください http://blogs.msdn.com/ieinternals/archive/2009/08/20/WinINET-IE-Cookie-Internals-FAQ.aspx。
WinINet API の他のすべての側面と同様に、この関数を DllMain またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。
Note
wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetSetCookie を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wininet.h |
| Library | Wininet.lib |
| [DLL] | Wininet.dll |