CInternetSession クラス
単一のインターネット セッションまたは複数の同時インターネット セッションを作成し、初期化します。必要な場合は、プロキシ サーバーへの接続も記述します。
class CInternetSession : public CObject
メンバー
パブリック コンストラクター
名前 |
説明 |
---|---|
CInternetSession オブジェクトを構築します。 |
パブリック メソッド
名前 |
説明 |
---|---|
インターネット セッションが終了すると、インターネット接続を閉じます。 |
|
状態のコールバックのルーチンを確立します。 |
|
インターネット セッションが終了すると、インターネット接続を閉じます。 |
|
指定した URL とそのすべての親の URL のクッキーを返します。 |
|
バッファーに格納するクッキーの長さを指定する変数を取得します。 |
|
FTP サーバーでセッションを開きます。ユーザーをログオンします。 |
|
接続を開くとしているアプリケーションの gopher サーバーを開きます。 |
|
接続を開くとしているアプリケーションの HTTP サーバーを開きます。 |
|
状態のコールバックが有効になっているときの操作の状態を更新します。 |
|
URL 解析し、を開きます。 |
|
指定した URL のクッキーを設定します。 |
|
インターネット セッションのオプションを設定します。 |
パブリック演算子
名前 |
説明 |
---|---|
現在のインターネット セッションへのハンドル。 |
解説
アプリケーションを実行している間インターネット接続を維持しておく必要がある場合、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 のクッキー データベースを管理できます。このデータベースを通じて、サーバーとスクリプトがクライアント ワークステーションに関するステータス情報を管理します。
基本的なインターネット プログラミングの詳細については、「WinInet の基礎」を参照してください。MFC WinInet クラスの使用に関する一般情報については、「Win32 インターネット拡張機能 (WinInet)」を参照してください。
[!メモ]
指定したサービスの種類がサポートされていない場合、CInternetSession は AfxThrowNotSupportedException をスローします。現在サポートされているサービスの種類は、FTP、HTTP、gopher、file だけです。
継承階層
CInternetSession
必要条件
ヘッダー: afxinet.h