CInternetSession クラス

更新 : 2007 年 11 月

単一のインターネット セッションまたは複数の同時インターネット セッションを作成し、初期化します。必要な場合は、プロキシ サーバーへの接続も記述します。

class CInternetSession : public CObject

解説

アプリケーションを実行している間インターネット接続を維持しておく必要がある場合、CWinApp クラスの CInternetSession メンバを作成します。

インターネット セッションを確立すると、OpenURL を呼び出すことができます。CInternetSession によってグローバル関数 AfxParseURL が呼び出され、自動的に URL が解析されます。プロトコルの種類に関係なく、CInternetSession は URL を解釈し、必要に応じて処理します。URL リソース "file://" で識別されるローカル ファイルのリクエストを処理できます。OpenURL は、指定された名前がローカル ファイルであった場合、CStdioFile オブジェクトへのポインタを返します。

OpenURL を使用してインターネット サーバー上の URL を開くと、そのサイトから情報を読み取ることができます。HTTP、FTP、gopher などのサービスに固有のアクションをサーバー上のファイルに対して実行するには、サーバーとの間で適切な接続を確立しておく必要があります。特定のサービスに対して特定の種類の接続を直接開くには、次のメンバ関数のうち 1 つを使用します。

SetOption を使用すると、タイムアウト値や再試行回数など、セッションのクエリ オプションを設定できます。

CInternetSession のメンバ関数 SetCookieGetCookieGetCookieLength を使用して、Win32 の Cookie データベースを管理できます。このデータベースを通じて、サーバーとスクリプトがクライアント ワークステーションに関するステータス情報を管理します。

基本的なインターネット プログラミングの詳細については、「WinInet の基礎」を参照してください。MFC WinInet クラスの使用に関する一般情報については、「Win32 インターネット拡張機能 (WinInet)」を参照してください。

cttkhz64.alert_note(ja-jp,VS.90).gifメモ :

指定したサービスの種類がサポートされていない場合、CInternetSessionAfxThrowNotSupportedException をスローします。現在サポートされているサービスの種類は、FTP、HTTP、gopher、file だけです。

必要条件

ヘッダー : afxinet.h

スマート デバイス開発者のためのメモ

スマート デバイス バージョンの CInternetSession クラス では、次のメソッドはサポートされません。

スマート デバイスの MFC では、FTP や Gopher のクラスはサポートされません。また、Windows CE の WinInet API では、Cookie や Gopher はサポートされません。

参照

参照

CObject クラス

階層図

CInternetConnection クラス

CHttpConnection クラス

CFtpConnection クラス

CGopherConnection クラス

その他の技術情報

CInternetSession のメンバ