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 を使用したインターネット プログラミングに関する記事を参照してください。
継承階層
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;
関連項目
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示