CInternetSession::GetHttpConnection

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

HTTP 接続を確立し、CHttpConnection オブジェクトへのポインタを取得します。

CHttpConnection* GetHttpConnection(
   LPCTSTR pstrServer,
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
   LPCTSTR pstrUserName = NULL,
   LPCTSTR pstrPassword = NULL 
);
CHttpConnection* GetHttpConnection(
   LPCTSTR pstrServer,
   DWORD dwFlags,
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
   LPCTSTR pstrUserName = NULL,
   LPCTSTR pstrPassword = NULL 
);

パラメータ

pstrServer
HTTP サーバー名を含んでいる文字列へのポインタ。
nPort
サーバー上で使用する TCP/IP ポートを識別する番号。
pstrUserName
ユーザー名が含まれている文字列へのポインタ。
pstrPassword
アクセスパスワードが含まれている文字列へのポインタ。
dwflags
INTERNET_ FLAG_* フラグの任意の組み合わせ。dwFlags の値については、「CHttpConnection::OpenRequest」の「解説」の表を参照してください。

戻り値

CHttpConnection オブジェクトへのポインタを返します。呼び出しに失敗した場合は、スローされた CInternetException オブジェクトを調べて、失敗の原因を特定してください。

解説

GetHttpConnection は、HTTP サーバーに接続し、CHttpConnection オブジェクトへのポインタを作成して返します。サーバー上で特定の操作を実行することはありません。たとえば、HTTP ヘッダーを問い合わせるには、その操作を別の手順として実行する必要があります。HTTP サーバーとの接続を使用して実行できる操作については、CHttpConnection クラスと CHttpFile クラスを参照してください。HTTP サイトを参照する方法については、メンバ関数 OpenURL を参照してください。一般的な HTTP 接続タスクを実行する手順については、「Win32 インターネット拡張機能 (WinInet)」を参照してください。