CHttpConnection::OpenRequest
HTTP 接続を開くには、このメンバー関数を呼び出します。
CHttpFile* OpenRequest(
LPCTSTR pstrVerb,
LPCTSTR pstrObjectName,
LPCTSTR pstrReferer = NULL,
DWORD_PTR dwContext = 1,
LPCTSTR* ppstrAcceptTypes = NULL,
LPCTSTR pstrVersion = NULL,
DWORD dwFlags = INTERNET_FLAG_EXISTING_CONNECT
);
CHttpFile* OpenRequest(
int nVerb,
LPCTSTR pstrObjectName,
LPCTSTR pstrReferer = NULL,
DWORD_PTR dwContext = 1,
LPCTSTR* ppstrAcceptTypes = NULL,
LPCTSTR pstrVersion = NULL,
DWORD dwFlags = INTERNET_FLAG_EXISTING_CONNECT
);
パラメーター
pstrVerb
要求で使用する動詞を含む文字列へのポインター。nullが使用されている場合、「終了」。pstrObjectName
指定した動詞のターゲット オブジェクトを含む文字列へのポインター。これは、通常、ファイル名、実行可能モジュール、または検索の指定子です。pstrReferer
要求 (pstrObjectName) の URL が派生ドキュメントの アドレス (URL) を指定する文字列へのポインター。nullが、HTTP ヘッダー指定されません。dwContext
OpenRequest 操作のコンテキストの識別子。dwContextに関する詳細については、[コメント] を参照してください。ppstrAcceptTypes
コンテンツ タイプを示す文字列への LPCTSTR のポインターの null で終わる配列へのポインターは、クライアントが受け入れました。ppstrAcceptTypes が null場合、サーバーはクライアントが型「」text/* 文書だけを使用して解釈します (つまり、テキスト ドキュメントだけで、画像またはそのほかのバイナリ ファイル)。コンテンツ タイプは情報をアタッチしたクエリのデータ型を識別する HTTP POST などの CGI の変数 CONTENT_TYPE 設定と同じです。pstrVersion
HTTP バージョンを定義する文字列へのポインター。nullは、「」HTTP/1.0 使用されます。dwFlags
INTERNET_ FLAG_* のフラグの組み合わせ。dwFlags の値については、[コメント] を参照してください。nVerb
HTTP 要求の種類に関連付けられた番号。次のいずれかになります。HTTP 要求の種類
nVerb の値
HTTP_VERB_POST
0
HTTP_VERB_GET
1
HTTP_VERB_HEAD
2
HTTP_VERB_PUT
3
HTTP_VERB_LINK
4
HTTP_VERB_DELETE
5
HTTP_VERB_UNLINK
6
戻り値
必要な CHttpFile オブジェクトへのポインター。
解説
dwFlags は次のいずれかになります。
インターネットのフラグ |
説明 |
---|---|
INTERNET_FLAG_RELOAD |
応答元のサーバーから、キャッシュから要求されたファイル、オブジェクト、またはディレクトリの一覧を強制的にダウンロードします。 |
INTERNET_FLAG_DONT_CACHE |
キャッシュに返されたエンティティを追加しません。 |
INTERNET_FLAG_MAKE_PERSISTENT |
永続的なエンティティとしてキャッシュに返されたエンティティを追加します。これは、標準クリーンアップ チェックする一貫性をキャッシュするか、ガベージ コレクションがこのキャッシュから項目を削除できないことを意味します。 |
INTERNET_FLAG_SECURE |
使用はトランザクション セマンティクスを保証します。これは SSL/PCT の使用に移動する HTTP 要求でのみ意味が、 |
INTERNET_FLAG_NO_AUTO_REDIRECT |
リダイレクトは CHttpFile::SendRequestで自動的に処理しないことを HTTP でのみ使用して、指定します。 |
任意の値にコンテキストの識別子を設定するに dwContext の既定値をオーバーライドします。コンテキストの識別子は CInternetSession のオブジェクトによって作成された CHttpConnection のオブジェクトの特定の操作に関連付けられます。値は CInternetSession::OnStatusCallback に識別される操作で状態を提供するために戻ります。コンテキストの識別子の詳細については、" " インターネットの対処方法: WinInet を参照してください。
必要条件
Header: afxinet.h