HTTP_DATA_CHUNK-Struktur (http.h)

Die HTTP_DATA_CHUNK-Struktur stellt einen einzelnen Datenblock im Arbeitsspeicher, in einer Datei oder im Antwortfragmentcache der HTTP-Server-API dar.

Syntax

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;

Member

DataChunkType

Typ des Datenspeichers. Dieser Member kann einer der Werte aus der HTTP_DATA_CHUNK_TYPE-Enumeration sein.

FromMemory

FromMemory.pBuffer

Zeiger auf die Startspeicheradresse des Datenblocks.

FromMemory.BufferLength

Länge des Datenblocks in Bytes.

FromFileHandle

FromFileHandle.ByteRange

Eine HTTP_BYTE_RANGE-Struktur , die die Gesamte oder einen Teil der Datei angibt. Um die gesamte Datei anzugeben, legen Sie das StartingOffset-Element auf 0 und das Length-Element auf HTTP_BYTE_RANGE_TO_EOF fest.

FromFileHandle.FileHandle

Öffnen Sie das Handle für die betreffende Datei.

FromFragmentCache

FromFragmentCache.FragmentNameLength

Länge des Fragmentnamens in Byte ohne das abschließende NULL-Zeichen.

FromFragmentCache.pFragmentName

Zeiger auf eine Zeichenfolge, die den Fragmentnamen enthält, der zugewiesen wurde, als das Fragment mithilfe der HttpAddFragmentToCache-Funktion dem Antwortfragmentcache hinzugefügt wurde.

FromFragmentCacheEx

FromFragmentCacheEx.ByteRange

Eine HTTP_BYTE_RANGE Struktur, die den Bytebereich im zwischengespeicherten Fragment angibt.

FromFragmentCacheEx.pFragmentName

Zeiger auf eine Zeichenfolge, die den Fragmentnamen enthält, der zugewiesen wurde, als das Fragment mithilfe der HttpAddFragmentToCache-Funktion dem Antwortfragmentcache hinzugefügt wurde. Die Länge der Zeichenfolge darf 65532 Bytes nicht überschreiten.

Hinweis Diese Zeichenfolge muss NULL beendet sein.

 

Trailers

Trailers.TrailerCount

Anzahl der HTTP_UNKNOWN_HEADER Strukturen im Array, auf das pTrailers verweist.

Trailers.pTrailers

Zeiger auf ein Array von HTTP_UNKNOWN_HEADER Strukturen, die die Anhänger enthalten.

FromWinHttpFastForwarding

FromWinHttpFastForwarding.WhFastForwardingData

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	http.h

Weitere Informationen

STRUKTUREN der HTTP-Server-API, Version 1.0

HTTP_REQUEST

HTTP_RESPONSE

HttpAddFragmentToCache

HttpSendResponseEntityBody