CInternetSession::GetHttpConnection

[アーティクル]
08/09/2011

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)」を参照してください。