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 を許可または禁止するかどうかをユーザーに確認するダイアログ ボックスが画面に表示されることがあります。

注意InternetSetCookie は、インターネット エクスプローラーで "すべての Cookie をブロック" が設定されている場合でも、無条件に Cookie を作成します。 この動作は、"すべての Cookie をブロックする" 設定がアクティブになっている間に、そのような Cookie がサーバーに送信されない場合でも、プライバシーの侵害と見なすことができます。 アプリケーションでは、ユーザーのプライバシー設定を正しく尊重するために InternetSetCookieEx を使用する必要があります。

Cookie 内部の詳細については、「」を参照してください http://blogs.msdn.com/ieinternals/archive/2009/08/20/WinINET-IE-Cookie-Internals-FAQ.aspx

 

WinINet API の他のすべての側面と同様に、この関数を DllMain またはグローバル オブジェクトのコンストラクターとデストラクター内から安全に呼び出すことはできません。

メモ WinINet では、サーバーの実装はサポートされていません。 また、サービスから使用しないでください。 サーバーの実装またはサービスの場合は、 Microsoft Windows HTTP サービス (WinHTTP) を使用します。
 

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

関連項目

HTTP Cookie

InternetGetCookie

InternetGetCookieEx

InternetSetCookieEx

Cookie の管理

WinINet 関数