CInternetSession::GetCookie
このメンバー関数は、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