CInternetSession::GetCookie
更新 : 2007 年 11 月
このメンバ関数は、Windows SDK に記述されている Win32 関数 InternetGetCookie の動作を実装します。
static BOOL GetCookie(
LPCTSTR pstrUrl,
LPCTSTR pstrCookieName,
LPTSTR pstrCookieData,
DWORD dwBufLen
);
static BOOL GetCookie(
LPCTSTR pstrUrl,
LPCTSTR pstrCookieName,
CString& strCookieData
);
パラメータ
pstrUrl
URL が含まれている文字列へのポインタ。pstrCookieName
指定された URL に関して取得する Cookie の名前を含んでいる文字列へのポインタ。pstrCookieData
1 つ目のオーバーロードでは、Cookie のデータを受け取るバッファのアドレスが含んでいる文字列へのポインタ。この値には、NULL を指定できます。2 つ目のオーバーロードでは、Cookie のデータを受け取る CString オブジェクトへの参照。dwBufLen
pstrCookieData バッファのサイズを指定する変数。関数が正常終了すると、バッファは pstrCookieData バッファにコピーされた量のデータを受け取ります。pstrCookieData が NULL の場合、このパラメータは、すべての Cookie データをコピーするために必要とされるバッファのサイズを指定する値を受け取ります。
戻り値
正常終了した場合は TRUE を返します。それ以外の場合は FALSE を返します。呼び出しに失敗した場合、Win32 関数 GetLastError を呼び出してエラーの原因を調べてください。返されるエラー値は、次のとおりです。
ERROR_NO_MORE_ITEMS 指定された URL とそのすべての親 URL に関する Cookie データがありません。
ERROR_INSUFFICIENT_BUFFER すべての Cookie データをコピーするには、dwBufLen に渡された値では不十分です。dwBufLen に返された値が、すべてのデータを取得するために必要なバッファのサイズになります。
解説
2 つ目のオーバーロードでは、MFC は Cookie データを取得し、指定された CString オブジェクトに渡します。
必要条件
ヘッダー : afxinet.h