CInternetSession::CInternetSession
このメンバー関数は CInternetSession のオブジェクトが作成されたときに呼び出されます。
CInternetSession(
LPCTSTR pstrAgent = NULL,
DWORD_PTR dwContext = 1,
DWORD dwAccessType = PRE_CONFIG_INTERNET_ACCESS,
LPCTSTR pstrProxyName = NULL,
LPCTSTR pstrProxyBypass = NULL,
DWORD dwFlags = 0
);
パラメーター
pstrAgent
インターネットの関数 (Microsoft Internet 「ブラウザー」) を呼び出すアプリケーションまたはエンティティの名前を識別する文字列へのポインター。pstrAgent が null (既定値) の場合、フレームワークはアプリケーション名を含む null で終わる文字列を返すグローバル関数 AfxGetAppNameを呼び出します。あるプロトコルはサーバーにアプリケーションを識別するためにこの文字列を使用します。dwContext
操作のコンテキストの識別子。dwContext は CInternetSession::OnStatusCallbackによって返される操作のステータス情報を指定します。既定値は 1 に設定されています; ただし、明示的に操作の特定のコンテキスト ID を割り当てることができます。作業そのコンテキスト ID、オブジェクト、およびオブジェクトが関連付けられています。dwAccessType
必要なアクセスの種類。有効な値は次に、そのうちの一つはことがあります。指定されたです:レジストリの構成済みの設定を使用してINTERNET_OPEN_TYPE_PRECONFIG の接続。このアクセスの種類を既定として設定されます。TIS プロキシによって接続するには、この値をに設定します dwAccessType ; その後、レジストリを適切に設定します。
インターネットに接続INTERNET_OPEN_TYPE_DIRECT の直接。
CERN プロキシによってINTERNET_OPEN_TYPE_PROXY の接続。
プロキシと異なる型の接続の詳細については、一般的な FTP のクライアント アプリケーションの手順を参照してください。
pstrProxyName
dwAccessType が INTERNET_OPEN_TYPE_PROXYとして設定する CERN プロキシの名前。既定値は nullです。pstrProxyBypass
サーバー アドレスのオプションの一覧を含む文字列へのポインター。これらのアドレスはプロキシにアクセスするときにスキップされる場合があります。null の値を指定する場合は、バイパス リストには、レジストリから読み取ります。このパラメーターは dwAccessTypeINTERNET_OPEN_TYPE_PROXYがに設定されている場合にのみ意味を持ちます。dwFlags
さまざまなキャッシュのオプションを示します。既定値は 0 に設定されます。使用できる値は次のとおりです。:INTERNET_FLAG_DONT_CACHE は、ローカルまたはゲートウェイのすべてのサーバーでデータをキャッシュしません。
INTERNET_FLAG_OFFLINE のダウンロード操作は、永続的なキャッシュを介してのみ読み込まれます。キャッシュに項目がない場合は、適切なエラー コードが返されます。このフラグは、ビットごとに組み合わせることがあります ( OR**|**) 演算子を使用して、複数のオプションを指定できます。
解説
CInternetSession は、アプリケーションによって呼び出される最初のインターネット関数です。また、内部データ構造体を初期化し、アプリケーションからの呼び出しを準備します。
インターネット接続を開くことができない CInternetSession は AfxThrowInternetExceptionをスローします。
使用例
CFtpFileFindの例を参照してください。
必要条件
Header: afxinet.h