structure HTTP_DATA_CHUNK (http.h)

Article
03/02/2024

La structure HTTP_DATA_CHUNK représente un bloc de données individuel en mémoire, dans un fichier ou dans le cache de fragments de réponse de l’API du serveur HTTP.

Syntaxe

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;

Membres

DataChunkType

Type de magasin de données. Ce membre peut être l’une des valeurs de l’énumération HTTP_DATA_CHUNK_TYPE .

FromMemory

FromMemory.pBuffer

Pointeur vers l’adresse mémoire de départ du bloc de données.

FromMemory.BufferLength

Longueur, en octets, du bloc de données.

FromFileHandle

FromFileHandle.ByteRange

Structure HTTP_BYTE_RANGE qui spécifie tout ou partie du fichier. Pour spécifier le fichier entier, définissez le membre StartingOffset sur zéro et le membre Lengthsur HTTP_BYTE_RANGE_TO_EOF.

FromFileHandle.FileHandle

Ouvrez handle sur le fichier en question.

FromFragmentCache

FromFragmentCache.FragmentNameLength

Longueur, en octets, du nom du fragment sans le caractère null de fin.

FromFragmentCache.pFragmentName

Pointeur vers une chaîne qui contient le nom de fragment attribué lorsque le fragment a été ajouté au cache de fragments de réponse à l’aide de la fonction HttpAddFragmentToCache .

FromFragmentCacheEx

FromFragmentCacheEx.ByteRange

Une structure HTTP_BYTE_RANGE spécifiant la plage d’octets dans le fragment mis en cache.

FromFragmentCacheEx.pFragmentName

Pointeur vers une chaîne qui contient le nom de fragment attribué lorsque le fragment a été ajouté au cache de fragments de réponse à l’aide de la fonction HttpAddFragmentToCache . La longueur de la chaîne ne peut pas dépasser 65532 octets.

Note Cette chaîne doit être terminée par null.

Trailers

Trailers.TrailerCount

Nombre de structures HTTP_UNKNOWN_HEADER dans le tableau pointé par pTrailers.

Trailers.pTrailers

Pointeur vers un tableau de structures HTTP_UNKNOWN_HEADER contenant les bandes-annonces.

FromWinHttpFastForwarding

FromWinHttpFastForwarding.WhFastForwardingData

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	http.h

Voir aussi

Structures de l’API serveur HTTP version 1.0

HTTP_REQUEST

HTTP_RESPONSE

HttpAddFragmentToCache

HttpSendResponseEntityBody

Partager via