InternetSetCookieA 関数 (wininet.h)

[アーティクル]
03/13/2024

指定した URL に関連付けられている Cookie を作成します。

構文

BOOL InternetSetCookieA(
  [in] LPCSTR lpszUrl,
  [in] LPCSTR lpszCookieName,
  [in] LPCSTR lpszCookieData
);

パラメーター

[in] lpszUrl

Cookie を設定する URL を指定する null で終わる文字列へのポインター。

[in] lpszCookieName

Cookie データに関連付ける名前を指定する null で終わる文字列へのポインター。このパラメーターが NULL の場合、Cookie に関連付けられている名前はありません。

[in] lpszCookieData

URL に関連付ける実際のデータへのポインター。

戻り値

成功した場合は TRUE 、それ以外の場合 は FALSE を 返します。特定のエラーメッセージを取得するには、 GetLastError を呼び出します。

注釈

有効期限のない InternetSetCookie によって作成された 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) を使用します。

注意

wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetSetCookie を定義します。エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wininet.h
Library	Wininet.lib
[DLL]	Wininet.dll