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 成員設定為零，並將 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 [僅限傳統型應用程式]
標頭	http.h

另請參閱

HTTP 伺服器 API 1.0 版結構

HTTP_REQUEST

HTTP_RESPONSE

HttpAddFragmentToCache

HttpSendResponseEntityBody