CInternetSession クラス

[アーティクル]
08/09/2011

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

class CInternetSession : public CObject

解説

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

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

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

GetGopherConnection。gopher サービスへの接続を開きます。
GetHttpConnection。HTTP サービスへの接続を開きます。
GetFtpConnection。FTP サービスへの接続を開きます。

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

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

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

注意

指定したサービスの種類がサポートされていない場合、CInternetSession は AfxThrowNotSupportedException をスローします。のみ、次のサービスの種類は現在サポートされています。FTP、HTTP、gopher、およびファイル。