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 |