CInternetSession::OpenURL
指定された要求を HTTP サーバーに送信し、クライアントを追加 RFC822、MIME、または HTTP ヘッダーを要求とともに送信するように指定する場合は、このメンバー関数を呼び出します。
CStdioFile* OpenURL(
LPCTSTR pstrURL,
DWORD_PTR dwContext = 1,
DWORD dwFlags = INTERNET_FLAG_TRANSFER_ASCII,
LPCTSTR pstrHeaders = NULL,
DWORD dwHeadersLength = 0
);
パラメーター
pstrURL
読み取り開始 URL の名前へのポインター。file:、ftp:、gopher:、または http で始まる URL のみ: サポートされます。pszURL がnull場合ASSERTS。dwContext
アプリケーション定義の値はコールバックの返されたハンドルで合格した場合。dwFlags
記述するフラグ。この接続を処理する方法を示します。有効なフラグに関する詳細については、[コメント] を参照してください。有効なフラグは次のとおりです:既定INTERNET_FLAG_TRANSFER_ASCII。ASCII テキストとしてファイルを転送します。
コピーINTERNET_FLAG_TRANSFER_BINARY のバイナリ ファイルとしてファイル。
INTERNET_FLAG_RELOAD は、からローカルにキャッシュされているデータを取得します。
INTERNET_FLAG_DONT_CACHE は、ローカルまたはゲートウェイで任意のデータをキャッシュしません。
INTERNET_FLAG_SECURE このフラグは、HTTP 要求のみ適用されます。これは、SSL (Secure Sockets Layer) または PCT を持つリンクの安全なトランザクションが必要です。
可能 な場合は、接続INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT 各要求に対して新しいセッションを作成する代わりに OpenUrl によって生成される新しい要求のサーバーへの接続を再利用します。
INTERNET_FLAG_PASSIVE は FTP サイトに使用します。パッシブ FTP のセマンティクスを使用します。OpenURLの CInternetConnection で使用します。
pstrHeaders
HTTP サーバーに送信されるヘッダーを含む文字列へのポインター。dwHeadersLength
長さ、ほかのヘッダーの文字単位)。これは -1L で、pstrHeaders が非null場合、はゼロ pstrHeaders 終了すると仮定し、長さが計算されます。
戻り値
GOPHER のみ、FTP、HTTP、ファイルの種類のインターネット サービスのファイル ハンドルを返します。解析は失敗 null を返します。
OpenURL が返すポインターは pszURL のサービスの種類によって異なります。次の表は、OpenURL を返すことができる可能なポインターを示しています。
URL 型 |
戻り値 |
|---|---|
file:// |
CStdioFile* |
http:// |
CHttpFile* |
gopher:// |
CGopherFile* |
ftp:// |
CInternetFile* |
解説
パラメーター dwFlags は INTERNET_FLAG_TRANSFER_ASCIIINTERNET_FLAG_TRANSFER_BINARY、または両方を含める必要があります。残りのフラグは、ビットごとの OR にまとめることができます (演算子**|**).
OpenURLは、Win32 関数 InternetOpenURLをラップするインターネット サーバーからデータをダウンロードし、取得し、読み取ることのみ割り当てます。OpenURL は、リモートの場所でファイルを処理できません。そのため、CInternetConnection オブジェクトを必要としません。
ファイルへの書き込みなどコネクション (つまり、特定のプロトコル固有の) 関数を使用するには、セッションを開く必要がありますが、接続、を使用した特定の種類をその目的の接続モードでファイルを開く開きます。接続された関数に関する詳細については、CInternetConnection を参照してください。
例外
このメソッドは、型 **CInternetException***の例外をスローできます。
必要条件
Header: afxinet.h