HTTP_RESPONSE_V1構造体 (http.h)

[アーティクル]
08/24/2023

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

Share via

HTTP_RESPONSE_V1構造体 (http.h)

構文

メンバー

要件

関連項目

フィードバック

フィードバック

その他のリソース