InternetGetCookieExA 関数 (wininet.h)
InternetGetCookieEx 関数は、指定された URL に関連付けられている Cookie に格納されているデータを取得します。 InternetGetCookieとは異なり、InternetGetCookieEx を使用して、取得したデータを単一の Cookie 名に制限したり、ポリシーによって信頼されていないサイトやサードパーティの Cookie に関連付けたりすることができます。
構文
BOOL InternetGetCookieExA(
[in] LPCSTR lpszUrl,
[in] LPCSTR lpszCookieName,
[in, out, optional] LPSTR lpszCookieData,
[in, out] LPDWORD lpdwSize,
[in] DWORD dwFlags,
[in] LPVOID lpReserved
);
パラメーター
[in] lpszUrl
取得するクッキーが関連付けられている URL を含む null終了文字列へのポインター。 このパラメーターを NULL
[in] lpszCookieName
取得する Cookie の名前を含む -terminated 文字列
[in, out, optional] lpszCookieData
Cookie データを受信するバッファーへのポインター。
[in, out] lpdwSize
DWORD 変数へのポインター。
入力時に、変数には、pchCookieData パラメーターによって指されるバッファーのサイズ (TCHAR) が含まれている必要があります。
終了時に関数が成功した場合、この変数には、バッファーにコピーされた Cookie データの TCHAR の数が含まれます。 null が lpszCookieData パラメーターとして渡された場合、または関数が ERROR_INSUFFICIENT_BUFFERのエラーで失敗した場合、変数には Cookie データを受信するために必要なバッファーのサイズ (BYTEs) が含まれます。
このパラメーターを NULL
[in] dwFlags
関数が Cookie データを取得する方法を制御するフラグ。 このパラメーターには、次のいずれかの値を指定できます。
[in] lpReserved
将来の使用のために予約されています。 NULL
戻り値
関数が成功した場合、関数は TRUE
関数が失敗した場合は、FALSE
この関数では、次のエラー コードを設定できます。
| リターン コード | 形容 |
|---|---|
|
取得した Cookie データが、 |
|
|
|
指定された Cookie データを取得できなかった場合に返されます。 |
備考
手記
wininet.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして InternetGetCookieEx を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | wininet.h |
| ライブラリ | Wininet.lib |
| DLL | Wininet.dll |
関連項目
HTTP Cookie を
InternetSetCookieEx の
Cookie の管理の
WinINet Functions の