HTTP_RESPONSE_V1構造体 (http.h)

HTTP_RESPONSE_V1構造体には、HTTP 応答に関連付けられたデータが含まれています。

コード内 でHTTP_RESPONSE_V1 を直接使用しないでください。 代わりに HTTP_RESPONSE を使用して、コードがコンパイルされるオペレーティング システムに基づいて適切なバージョンが使用されるようにします。

構文

typedef struct _HTTP_RESPONSE_V1 {
  ULONG                 Flags;
  HTTP_VERSION          Version;
  USHORT                StatusCode;
  USHORT                ReasonLength;
  PCSTR                 pReason;
  HTTP_RESPONSE_HEADERS Headers;
  USHORT                EntityChunkCount;
  PHTTP_DATA_CHUNK      pEntityChunks;
} HTTP_RESPONSE_V1, *PHTTP_RESPONSE_V1;

メンバー

Flags

省略可能なログ フラグは、既定の応答動作を変更します。 これらは、 HTTP_RESPONSE_FLAG 値のいずれかになります。

Version

このメンバーは無視されます。応答は常に HTTP/1.1 応答です。

StatusCode

HTTP 要求の結果を特徴付けた数値状態コード (たとえば、200 は "OK" を示し、404 は "Not Found" を示します)。 これらのコードの詳細と一覧については、 RFC 2616 のセクション 10 を参照してください。

要求が予約されているが登録されていない URL に送信され、それを処理する適切なアプリケーションが実行されていないことを示す場合、HTTP Server API 自体は状態コード 400 の応答を返し、"Bad Request" を示します。 これは、アプリケーションに対して透過的です。 コード 400 はここで 503 ("サーバーが使用できません") に優先されます。後者は、一部のスマート ロード バランサーによってサーバーが過負荷であることを示すものとして解釈されるためです。

ReasonLength

pReason メンバーが指す文字列のサイズ (バイト単位)。 0 を指定できます。

pReason

HTTP 要求の結果を特徴付ける印刷可能な文字 ("OK" や "Not Found" など) を示す、人間が読み取り可能な null で終わる文字列へのポインター。

Headers

この応答で使用されるヘッダーを含む HTTP_RESPONSE_HEADERS 構造体。

EntityChunkCount

pEntityChunks 配列で指定されたエンティティ本体データ ブロックの数。 この数は 100 を超えることはできません。 応答にエンティティ本文がない場合、このメンバーは 0 である必要があります。

pEntityChunks

応答のエンティティ本体を構成するすべてのデータ ブロックを一緒に指定する、 HTTP_DATA_CHUNK 構造体の配列。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header http.h

関連項目

HTTP Server API バージョン 2.0 構造体

HTTP_DATA_CHUNK

HTTP_REQUEST

HTTP_RESPONSE

HTTP_RESPONSE_HEADERS

HTTP_RESPONSE_V2

HttpSendHttpResponse