InternetGetCookieExW

指定した URL に関連付けられたクッキーに格納されているデータを取得する。(Unicode)

InternetGetCookieExW lpszUrl, lpszCookieName, lpszCookieData, lpdwSize, dwFlags, lpReserved

lpszUrl : [wstr] 取得するクッキーが関連付けられている URL を格納した null 終端文字列へのポインタ。本パラメータに NULL を指定することはできない。NULL を指定すると InternetGetCookieEx は失敗し、ERROR_INVALID_PARAMETER エラーを返す。
lpszCookieName : [wstr] 取得するクッキーの名前を格納した null 終端文字列へのポインタ。この名前は大文字小文字を区別する。
lpszCookieData : [wstr] クッキーデータを受け取るバッファへのポインタ。
lpdwSize : [var] DWORD 変数へのポインタ。入力時、変数には pchCookieData パラメータが指すバッファのサイズ (TCHAR 単位) を格納しなければならない。出力時、関数が成功した場合、変数にはバッファにコピーされたクッキーデータの TCHAR 数が格納される。lpszCookieData パラメータに NULL が渡された場合、または関数が ERROR_INSUFFICIENT_BUFFER エラーで失敗した場合、変数にはクッキーデータを受け取るために必要なバッファのサイズ (バイト単位) が格納される。本パラメータに NULL を指定することはできない。NULL を指定すると InternetGetCookieEx は失敗し、ERROR_INVALID_PARAMETER エラーを返す。
dwFlags : [int] 
lpReserved : [intptr] 将来の使用のために予約されている。NULL を設定すること。

(プラグイン / モジュール : wininet.dll)

解説

指定した URL に関連付けられたクッキーに格納されているデータを取得する。(Unicode)

[戻り値]
関数が成功した場合、戻り値は TRUE である。
関数が失敗した場合、戻り値は FALSE である。具体的なエラー値を取得するには GetLastError
を呼び出す。lpszCookieData に NULL を渡した場合、呼び出しは成功し、関数は
ERROR_INSUFFICIENT_BUFFER を設定しない。
本関数は次のエラーコードを設定することがある。
(以下省略)

[備考]
注意: WinINet はサーバー実装をサポートしていない。さらに、サービスから使用すべきでもない。サーバー実装やサービスでは
Microsoft Windows HTTP Services (WinHTTP) を使用すること。
> [!NOTE] > wininet.h ヘッダーは InternetGetCookieEx
をエイリアスとして定義しており、UNICODE プリプロセッサ定数の定義に基づいて本関数の ANSI 版または Unicode
版を自動的に選択する。エンコーディング中立のエイリアスとエンコーディング中立でないコードを混在させると、コンパイルエラーや実行時エラーの原因となるミスマッチが発生する可能性がある。詳細は
[Conventions for Function
Prototypes](/windows/win32/intl/conventions-for-function-prototypes)
を参照のこと。

情報

プラグイン / モジュールwininet.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の wininet.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_wininet_gen2.hs