HTTP_DATA_CHUNK構造体 (http.h)

HTTP_DATA_CHUNK構造体は、メモリ、ファイル、または HTTP Server API 応答フラグメント キャッシュ内の個々のデータ ブロックを表します。

構文

typedef struct _HTTP_DATA_CHUNK {
  HTTP_DATA_CHUNK_TYPE DataChunkType;
  union {
    struct {
      PVOID pBuffer;
      ULONG BufferLength;
    } FromMemory;
    struct {
      HTTP_BYTE_RANGE ByteRange;
      HANDLE          FileHandle;
    } FromFileHandle;
    struct {
      USHORT FragmentNameLength;
      PCWSTR pFragmentName;
    } FromFragmentCache;
    struct {
      HTTP_BYTE_RANGE ByteRange;
      PCWSTR          pFragmentName;
    } FromFragmentCacheEx;
    struct {
      USHORT               TrailerCount;
      PHTTP_UNKNOWN_HEADER pTrailers;
    } Trailers;
    struct {
      HTTP_WINHTTP_FAST_FORWARDING_DATA WhFastForwardingData;
    } FromWinHttpFastForwarding;
  };
} HTTP_DATA_CHUNK, *PHTTP_DATA_CHUNK;

メンバー

DataChunkType

データ ストアの種類。 このメンバーは、 HTTP_DATA_CHUNK_TYPE 列挙の値のいずれかになります。

FromMemory

FromMemory.pBuffer

データ ブロックの開始メモリ アドレスへのポインター。

FromMemory.BufferLength

データ ブロックの長さ (バイト単位)。

FromFileHandle

FromFileHandle.ByteRange

ファイル の すべてまたは一部を指定するHTTP_BYTE_RANGE構造体。 ファイル全体を指定するには、 StartingOffset メンバーを 0 に、 Length メンバーを HTTP_BYTE_RANGE_TO_EOFに設定します。

FromFileHandle.FileHandle

問題のファイルへのハンドルを開きます。

FromFragmentCache

FromFragmentCache.FragmentNameLength

終了する null 文字を含まないフラグメント名の長さ (バイト単位)。

FromFragmentCache.pFragmentName

HttpAddFragmentToCache 関数を使用してフラグメントが応答フラグメント キャッシュに追加されたときに割り当てられたフラグメント名を含む文字列へのポインター。

FromFragmentCacheEx

FromFragmentCacheEx.ByteRange

キャッシュされたフラグメント内のバイト範囲を指定する HTTP_BYTE_RANGE 構造体。

FromFragmentCacheEx.pFragmentName

HttpAddFragmentToCache 関数を使用してフラグメントが応答フラグメント キャッシュに追加されたときに割り当てられたフラグメント名を含む文字列へのポインター。 文字列の長さは 65532 バイトを超えることはできません。

メモ この文字列は NULL で終了する必要があります。

 

Trailers

Trailers.TrailerCount

pTrailers が指す配列内のHTTP_UNKNOWN_HEADER構造体の数。

Trailers.pTrailers

トレーラーを含む HTTP_UNKNOWN_HEADER 構造体の配列へのポインター。

FromWinHttpFastForwarding

FromWinHttpFastForwarding.WhFastForwardingData

要件

要件	値
サポートされている最小のクライアント	Windows Vista、WINDOWS XP と SP2 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
Header	http.h

こちらもご覧ください

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

HTTP_REQUEST

HTTP_RESPONSE

HttpAddFragmentToCache

HttpSendResponseEntityBody