次の方法で共有


CInternetConnection クラス

インターネット サーバーへの接続を管理します。

構文

class CInternetConnection : public CObject

メンバー

パブリック コンストラクター

名前 説明
CInternetConnection::CInternetConnection CInternetConnection オブジェクトを構築します。

パブリック メソッド

名前 説明
CInternetConnection::GetContext この接続オブジェクトのコンテキスト ID を取得します。
CInternetConnection::GetServerName 接続に関連付けられているサーバーの名前を取得します。
CInternetConnection::GetSession 接続に関連付けられている CInternetSession オブジェクトへのポインターを取得します。

パブリック演算子

名前 説明
CInternetConnection::operator HINTERNET インターネット セッションへのハンドル。

解説

これは、MFC クラス CFtpConnectionCHttpConnection、および CGopherConnection の基本クラスです。 これらの各クラスは、それぞれの FTP、HTTP、または gopher サーバーと通信するための追加機能を提供します。

インターネット サーバーと直接通信するには、 CInternetSession オブジェクトと CInternetConnection オブジェクトが必要です。

WinInet クラスのしくみの詳細については、「WinInet を使用したInternet プログラミングに関する記事を参照してください。

継承階層

CObject

CInternetConnection

要件

Header: afxinet.h

CInternetConnection::CInternetConnection

このメンバー関数は、CInternetConnection オブジェクトの作成時に呼び出されます。

CInternetConnection(
    CInternetSession* pSession,
    LPCTSTR pstrServer,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
    DWORD_PTR dwContext = 1);

パラメーター

pSession
CInternetSession オブジェクトへのポインター。

pstrServer
サーバー名を含む文字列へのポインター。

nPort
この接続のインターネット ポートを識別する番号。

dwContext
CInternetConnection オブジェクトのコンテキスト識別子。 dwContextの詳細については、「Remarks」を参照してください。

解説

自分 CInternetConnection 呼び出すことはありません。代わりに、確立する接続の種類に対して CInternetSession メンバー関数を呼び出します。

dwContext の既定値は、MFC によって、InternetConnection 派生オブジェクトを作成したCInternetSession オブジェクトからCInternetConnection派生オブジェクトに送信されます。 既定値は 1 に設定されています。ただし、接続の CInternetSession コンストラクターで特定のコンテキスト識別子を明示的に割り当てることができます。 オブジェクトとその作業は、そのコンテキスト ID に関連付けられます。 コンテキスト識別子が CInternetSession::OnStatusCallback に返され、識別されるオブジェクトの状態が提供されます。 コンテキスト識別子の詳細については、「 Internet First Steps: WinInet 」を参照してください。

CInternetConnection::GetContext

このメンバー関数を呼び出して、このセッションのコンテキスト ID を取得します。

DWORD_PTR GetContext() const;

戻り値

アプリケーション割り当てコンテキスト ID。

解説

コンテキスト ID はもともと CInternetSession で指定され、接続を開く関数の呼び出しで異なる方法で指定されていない限り、 CInternetConnection および CInternetFile 派生クラスに伝達されます。 コンテキスト ID は、指定されたオブジェクトの任意の操作に関連付け、 CInternetSession::OnStatusCallback によって返される操作の状態情報を識別します。

GetContext WinInet クラスと連携してユーザーの状態情報を提供する方法の詳細については、コンテキスト識別子の詳細については、「 Internet First Steps: WinInet 」を参照してください。

CInternetConnection::GetServerName

このメンバー関数を呼び出して、このインターネット接続に関連付けられているサーバーの名前を取得します。

CString GetServerName() const;

戻り値

この接続オブジェクトが操作しているサーバーの名前。

CInternetConnection::GetSession

このメンバー関数を呼び出して、この接続に関連付けられている CInternetSession オブジェクトへのポインターを取得します。

CInternetSession* GetSession() const;

戻り値

このインターネット接続オブジェクトに関連付けられている CInternetSession オブジェクトへのポインター。

CInternetConnection::operator HINTERNET

この演算子を使用して、現在のインターネット セッションの API レベルのハンドルを取得します。

operator HINTERNET() const;

関連項目

CObject クラス
階層図