次の方法で共有


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

参照

関連項目

CHttpConnection クラス

階層図

CHttpFile クラス

CInternetSession クラス

CFtpConnection クラス

CGopherConnection クラス

CInternetConnection クラス