CHttpFile::EndRequest

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

更新 : 2007 年 11 月

SendRequestEx メンバ関数で HTTP サーバーに送信した要求を終了します。

BOOL EndRequest(
   DWORD dwFlags = 0,
   LPINTERNET_BUFFERS lpBuffIn = NULL,
   DWORD_PTR dwContext = 1 
);

パラメータ

dwFlags
操作を指定するフラグ。有効なフラグの一覧については、Windows SDK の「HttpEndRequest」を参照してください。
lpBuffIn
操作に使用する入力バッファが記述された、初期化済み INTERNET_BUFFERS へのポインタ。
dwContext
CHttpFile 操作のコンテキスト ID。このパラメータの詳細については、「解説」を参照してください。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。呼び出しに失敗した場合は、スローされた CInternetException オブジェクトを調べて、失敗の原因を特定してください。

解説

dwContext の既定値は、MFC によって、CHttpFile オブジェクトを作成した CInternetSession オブジェクトから CHttpFile オブジェクトへ渡されます。CInternetSession::OpenURL または CHttpConnection を呼び出して CHttpFile オブジェクトを構築すると、既定値をオーバーライドして、コンテキスト ID を独自の値に設定できます。コンテキスト ID は、CInternetSession::OnStatusCallback に返され、該当するオブジェクトのステータスが通知されます。コンテキスト ID の詳細については、「WinInet の基礎」を参照してください。