struttura HTTP_DATA_CHUNK (http.h)

Articolo
02/26/2024

La struttura HTTP_DATA_CHUNK rappresenta un singolo blocco di dati in memoria, in un file o nella cache del frammento di risposta dell'API del server HTTP.

Sintassi

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;

Members

DataChunkType

Tipo di archivio dati. Questo membro può essere uno dei valori dell'enumerazione HTTP_DATA_CHUNK_TYPE .

FromMemory

FromMemory.pBuffer

Puntatore all'indirizzo di memoria iniziale del blocco di dati.

FromMemory.BufferLength

Lunghezza, in byte, del blocco di dati.

FromFileHandle

FromFileHandle.ByteRange

Struttura HTTP_BYTE_RANGE che specifica tutto o parte del file. Per specificare l'intero file, impostare il membro StartingOffset su zero e il membro Lengthsu HTTP_BYTE_RANGE_TO_EOF.

FromFileHandle.FileHandle

Aprire handle per il file in questione.

FromFragmentCache

FromFragmentCache.FragmentNameLength

Lunghezza, in byte, del nome del frammento che non include il carattere null di terminazione.

FromFragmentCache.pFragmentName

Puntatore a una stringa contenente il nome del frammento assegnato quando il frammento è stato aggiunto alla cache response-fragment usando la funzione HttpAddFragmentToCache .

FromFragmentCacheEx

FromFragmentCacheEx.ByteRange

Struttura HTTP_BYTE_RANGE che specifica l'intervallo di byte nel frammento memorizzato nella cache.

FromFragmentCacheEx.pFragmentName

Puntatore a una stringa contenente il nome del frammento assegnato quando il frammento è stato aggiunto alla cache response-fragment usando la funzione HttpAddFragmentToCache . La lunghezza della stringa non può superare i 65532 byte.

Nota Questa stringa deve essere null terminata.

Trailers

Trailers.TrailerCount

Conteggio del numero di strutture HTTP_UNKNOWN_HEADER nella matrice a cui punta pTrailers.

Trailers.pTrailers

Puntatore a una matrice di strutture HTTP_UNKNOWN_HEADER contenenti i trailer.

FromWinHttpFastForwarding

FromWinHttpFastForwarding.WhFastForwardingData

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	http.h

Vedi anche

Strutture dell'API server HTTP versione 1.0

HTTP_REQUEST

HTTP_RESPONSE

HttpAddFragmentToCache

HttpSendResponseEntityBody

Condividi tramite