InternetSetCookieA 関数 (wininet.h)

[アーティクル]
11/20/2024

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

構文

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

パラメーター

[in] lpszUrl

cookie を設定する URL を指定する、null終了文字列へのポインター。

[in] lpszCookieName

cookie データに関連付ける名前を指定する -terminated 文字列null へのポインター。このパラメーターが NULL場合、名前は Cookie に関連付けされません。

[in] lpszCookieData

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

戻り値

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

備考

有効期限のない InternetSetCookie によって作成された Cookie はメモリに格納され、作成したのと同じプロセスでのみ使用できます。有効期限を含む Cookie は、windows\cookies ディレクトリに格納されます。

新しい Cookie を作成すると、ユーザーのプライバシー設定に基づいて、このサイトの Cookie を許可または禁止するかどうかをユーザーに確認するダイアログボックスが画面に表示されることがあります。

InternetSetCookie注意: Internet Explorer で [すべての 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 Services (WinHTTP)を使用します。

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされる最小サーバー	Windows 2000 Server [デスクトップアプリのみ]
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	wininet.h
ライブラリ	Wininet.lib
DLL	Wininet.dll

次の方法で共有

InternetSetCookieA 関数 (wininet.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース