CInternetConnection クラス

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

構文

class CInternetConnection : public CObject

メンバー

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

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

パブリック メソッド

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

パブリック演算子

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

解説

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

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

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

継承階層

CObject

CInternetConnection

必要条件

ヘッダー: 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 の詳細については、「解説」を参照してください。

解説

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

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

CInternetConnection::GetContext

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

DWORD_PTR GetContext() const;

戻り値

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

解説

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

他の WinInet クラスと連携してユーザーの状態情報を提供する方法GetContextの詳細については、コンテキスト識別子の詳細については、インターネットの最初の手順: WinInet に関する記事を参照してください。

CInternetConnection::GetServerName

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

CString GetServerName() const;

戻り値

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

CInternetConnection::GetSession

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

CInternetSession* GetSession() const;

戻り値

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

CInternetConnection::operator HINTERNET

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

operator HINTERNET() const;

関連項目

CObject クラス
階層図