CInternetSession::CInternetSession

CInternetSession (LPCTSTR pstrAgent NULL、DWORD = dwContext = 1、DWORD dwAccessType INTERNET_OPEN_TYPE_PRECONFIG、LPCTSTR = pstrProxyName = NULL、LPCTSTR pstrProxyBypass = NULL、DWORD dwFlags = 0);

パラメーター

pstrAgent

アプリケーションまたはエンティティのインターネット関数 (たとえば、「Microsoft インターネットブラウザー」) の呼び出しの名前を示す文字列へのポインター。PstrAgentがNULL (既定値) の場合は、グローバル関数AfxGetAppNameは、アプリケーションの名前を含む null で終わる文字列を返します、フレームワークを呼び出します。一部のプロトコルでこの文字列を使用して、サーバーにアプリケーションを識別するために。

dwContext

操作のコンテキスト id。dwContext CInternetSession::OnStatusCallbackによって返される操作のステータス情報を識別します。既定値は 1 に設定する;ただし、操作の特定のコンテキスト ID を明示的に割り当てることができます。オブジェクトとは、作業時間は、そのコンテキスト ID に関連付けられてなりますINTERNET_FLAG_ASYNC dwFlagsが含まれる場合は、ステータスコールバックルーチンを登録されている限り、このオブジェクトによって作成されたオブジェクトの非同期動作があります。同期的に完了するための関数は、 dwContextの呼び出しを 0 に設定する必要があります。

dwAccessType

必要なアクセスの種類。次はの 1 つを指定することがあります、有効な値は:

INTERNET_OPEN_TYPE_PRECONFIG特価;(レジストリで) あらかじめ設定されています。このアクセスの種類を既定として設定されています。(&N)。
INTERNET_OPEN_TYPE_DIRECT特価;インターネットへの直接(&N)。
INTERNET_OPEN_TYPE_PROXY特価;CERN プロキシを介して(&N)。

pstrProxyName

DwAccessTypeはINTERNET_OPEN_TYPE_PROXYとして設定されている場合、優先の CERN プロキシの名前。既定値はNULLです。

pstrProxyBypass

サーバーアドレスのオプションの一覧を含む文字列へのポインター。これらのアドレスプロキシアクセスを使用する場合、バイパスされる可能性があります。NULL値を指定した場合は、バイパスリストをレジストリから読み取られます。このパラメーターはdwAccessType INTERNET_OPEN_TYPE_PROXYに設定されて場合にのみ意味が。

dwFlags

などのさまざまなオプションを示すキャッシュと非同期動作します。既定値は 0 に設定されます。可能な値が含まれます:

INTERNET_FLAG_DONT_CACHE特価;データをローカルまたは任意のゲートウェイサーバーをキャッシュしません。(&N)。
INTERNET_FLAG_ASYNC特価;このオブジェクトの将来操作ERROR_IO_PENDINGを失敗する可能性があります。操作が完了するとステータスコールバックINTERNET_STATUS_REQUEST_COMPLETEで行われます。このコールバックは、スレッドは元の要求の 1 つ以外のです。ステータス・コールバック・ルーチンを確立するには、 EnableStatusCallbackを呼び出す必要がありますまたは、関数を同期的に完了します。(&N)。
INTERNET_FLAG_OFFLINE特価;ダウンロード操作の永続的なキャッシュを通じてのみ満足しています。アイテムがキャッシュに存在しない場合は、適切なエラーコードが返されます。このフラグは、ビットごとのOR (&|) 演算子と組み合わせることができます。

解説

CInternetSessionオブジェクトが作成されたときに呼び出されます。CInternetSessionは、アプリケーションが最初のインターネットアクセス関数です。内部データ構造を初期化され、アプリケーションからの呼び出しを準備。

INTERNET_FLAG_ASYNC dwFlagsが含まれる場合は、ステータスコールバックルーチンを登録されている限り、このハンドルから派生したすべてのハンドル非同期動作をが。

インターネット接続を開いてない場合は、 CInternetSession AfxThrowInternetException をスローします。

CInternetSession 概要|nbsp;クラスメンバー |階層図(&N)

参照特価;CInternetSession::Close、 CInternetSession::EnableStatusCallback、 CInternetSession::GetContext(&N)

Index