HttpSendResponseEntityBody

HTTP 応答に関連付けられたエンティティボディデータを送信する。

HttpSendResponseEntityBody RequestQueueHandle, RequestId, Flags, EntityChunkCount, EntityChunks, BytesSent, Reserved1, Reserved2, Overlapped, LogData

RequestQueueHandle : [intptr] 指定リクエストを取得したリクエストキューへのハンドル。リクエストキューは HttpCreateRequestQueue で作成される。Windows Server 2003 SP1 および Windows XP SP2 ではハンドルは HttpCreateHttpHandle により作成される。
RequestId : [int64] この応答が対応する HTTP リクエストの識別子。HttpReceiveHttpRequest で返される HTTP_REQUEST の RequestId メンバの値。HTTP_NULL_ID は不可。
Flags : [int] 次の相互排他フラグ値のうち 1 つを含められるパラメータ。このドキュメントは省略されている。
EntityChunkCount : [int] pEntityChunks の配列内の構造体数。9999 を超えてはならない。
EntityChunks : [var] エンティティボディデータとして送る HTTP_DATA_CHUNK 構造体の配列へのポインタ。
BytesSent : [var] 任意。同期動作時に送信したバイト数を受け取る変数へのポインタ。非同期時は NULL にし、同期時は有効なアドレスが必要である。
Reserved1 : [intptr] 予約されている。NULL でなければならない。
Reserved2 : [int] 予約されている。0 でなければならない。
Overlapped : [var] 非同期呼び出しの場合は pOverlapped に OVERLAPPED 構造体へのポインタを設定する。同期呼び出しの場合は NULL にする。
LogData : [var] 応答のログ記録に使う HTTP_LOG_DATA 構造体へのポインタ。HTTP_LOG_FIELDS_DATA へのポインタを PHTTP_LOG_DATA にキャストして渡す。アプリがログフィールドデータ構造体を渡さないとログされない。Windows Server 2003 および Windows XP SP2 ではこのパラメータは予約されており NULL でなければならない。Windows Vista および Windows Server 2008 で新規。

(プラグイン / モジュール : httpapi.dll)

解説

HTTP 応答に関連付けられたエンティティボディデータを送信する。

[戻り値]
関数が成功すると戻り値は NO_ERROR となる。非同期で使用した場合 ERROR_IO_PENDING
は次のリクエストがまだ準備できていないことを示す。関数が失敗した場合、戻り値は次のいずれかのエラーコードとなる。このドキュメントは省略されている。

[備考]
Content-Length ヘッダも Transfer-Encoding
ヘッダも応答ヘッダに含まれない場合、HTTP_SEND_RESPONSE_DISCONNECT
フラグで接続を明示的に閉じて応答終了を示す必要がある。注: 同一 RequestId に対し
HttpSendResponseEntityBody (または HttpSendHttpResponse) と
HttpSendResponseEntityBody を別スレッドから同時に呼んではならない。

情報