次の方法で共有

InternetGetCookieA 関数 (wininet.h)

  • [アーティクル]

指定した URL の Cookie を取得します。

構文

BOOL InternetGetCookieA(
  [in]      LPCSTR  lpszUrl,
  [in]      LPCSTR  lpszCookieName,
  [out]     LPSTR   lpszCookieData,
  [in, out] LPDWORD lpdwSize
);

パラメーター

[in] lpszUrl

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

[in] lpszCookieName

実装されていません。

[out] lpszCookieData

Cookie データを受け取るバッファーへのポインター。 このパラメーターは NULLできます。

[in, out] lpdwSize

TCHAR の lpszCookieData パラメーター バッファーのサイズを指定する変数へのポインター。 関数が成功した場合、バッファーは lpszCookieData バッファーにコピーされたデータの量を受け取ります。 lpszCookieData が NULL場合、このパラメーターは、すべての Cookie データをコピーするために必要なバッファーのサイズをバイトカウントとして表す値を受け取ります。

戻り値

関数が成功した場合、関数は TRUE返します。

関数が失敗した場合は、FALSE返します。 拡張エラー データを取得するには、GetLastError呼び出します。

次のエラー値は、InternetGetCookieに適用されます。

リターン コード 形容
ERROR_NO_MORE_ITEMS
 指定された URL とそのすべての親に対する Cookie はありません。
ERROR_INSUFFICIENT_BUFFER
 lpdwSize 渡された値は、すべての Cookie データをコピーするには不十分です。 lpdwSize で返される値は、すべてのデータを取得するために必要なバッファーのサイズです。
ERROR_INVALID_PARAMETER
 1 つ以上のパラメーターが無効です。

lpszUrl パラメーターは NULLです。

備考

InternetGetCookie では、InternetOpenを する呼び出しは必要ありません。 internetGetCookie 、windows\cookies ディレクトリで、有効期限が将来設定される永続的な Cookie を確認します。 InternetGetCookie は、セッション Cookie (つまり、InternetSetCookieによって同じプロセスで作成された有効期限のない Cookie) をメモリで検索します。これは、これらの Cookie がファイルに書き込まれないためです。 Cookie ファイルを作成するための規則はシステムの内部であり、将来変更される可能性があります。

HTTP Cookieで説明したように、InternetGetCookie は、サーバーがスクリプト不可能としてマークされた Cookie を返しません。この Cookie は、Set-Cookie ヘッダーに "HttpOnly" 属性を持ちます。

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

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

手記

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

必要条件

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

関連項目

HTTP Cookie を する

InternetGetCookieEx

InternetSetCookie

InternetSetCookieEx の

Cookie の管理の

WinINet Functions の